CONTROL-D and CONTROL-V

User Guide

Supporting
Version 6.3.04 of CONTROL-D
Version 6.3.04 of CONTROL-V

March 2009

www.bmc.com
 Contacting BMC Software
You can access the BMC Software website at http://www.bmc.com. From this website, you can obtain information
about the company, its products, corporate offices, special events, and career opportunities.
United States and Canada
Address BMC SOFTWARE INC Telephone 713 918 8800 or Fax 713 918 8000
2101 CITYWEST BLVD 800 841 2031
HOUSTON TX 77042-2827
USA
Outside United States and Canada
Telephone (01) 713 918 8800 Fax (01) 713 918 8000

Copyright 2009 BMC Software, Inc.

BMC, BMC Software, and the BMC Software logo are the exclusive properties of BMC Software, Inc., are registered with the U.S. Patent
and Trademark Office, and may be registered or pending registration in other countries. All other BMC trademarks, service marks, and
logos may be registered or pending registration in the U.S. or in other countries. All other trademarks or registered trademarks are the
property of their respective owners.
BMC Software considers information included in this documentation to be proprietary and confidential. Your use of this information is
subject to the terms and conditions of the applicable End User License Agreement for the product and the proprietary and restricted
rights notices included in this documentation.

Restricted rights legend

U.S. Government Restricted Rights to Computer Software. UNPUBLISHED -- RIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF
THE UNITED STATES. Use, duplication, or disclosure of any data and computer software by the U.S. Government is subject to
restrictions, as applicable, set forth in FAR Section 52.227-14, DFARS 252.227-7013, DFARS 252.227-7014, DFARS 252.227-7015, and
DFARS 252.227-7025, as amended from time to time. Contractor/Manufacturer is BMC SOFTWARE INC, 2101 CITYWEST BLVD,
HOUSTON TX 77042-2827, USA. Any contract notices should be sent to this address.
 Customer support
You can obtain technical support by using the BMC Software Customer Support website or by contacting Customer
Support by telephone or e-mail. To expedite your inquiry, see Before contacting BMC.

Support website
You can obtain technical support from BMC 24 hours a day, 7 days a week at http://www.bmc.com/support_home.
From this website, you can
read overviews about support services and programs that BMC offers
find the most current information about BMC products
search a database for issues similar to yours and possible solutions
order or download product documentation
download products and maintenance
report an issue or ask a question
subscribe to receive proactive e-mail alerts when new product notices are released
find worldwide BMC support center locations and contact information, including e-mail addresses, fax numbers, and
telephone numbers

Support by telephone or e-mail

In the United States and Canada, if you need technical support and do not have access to the web, call 800 537 1813 or
send an e-mail message to [email protected]. (In the subject line, enter SupID:<yourSupportContractID>,
such as SupID:12345). Outside the United States and Canada, contact your local support center for assistance.

Before contacting BMC

Have the following information available so that Customer Support can begin working on your issue immediately:
product information
product name
product version (release number)
license number and password (trial or permanent)
operating system and environment information
machine type
operating system type, version, and service pack or other maintenance level such as PUT or PTF
system hardware configuration
serial numbers
related software (database, application, and communication) including type, version, and service pack or
maintenance level
sequence of events leading to the issue
commands and options that you used
messages received (and the time and date that you received them)
product error messages
messages from the operating system, such as file system full
messages from related software

3
 License key and password information
If you have questions about your license key or password, contact BMC as follows:
(USA or Canada) Contact the Order Services Password Team at 800 841 2031, or send an e-mail message to
[email protected].
(Europe, the Middle East, and Africa) Fax your questions to EMEA Contracts Administration at +31 20 354 8702, or send
an e-mail message to [email protected].
(Asia-Pacific) Contact your BMC sales representative or your local BMC office.

4 CONTROL-D and CONTROL-V User Guide

Contents
About This Guide 33
Conventions Used in This Guide. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Information New to This Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Related Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Chapter 1 Introduction 39
INCONTROL Products and IOA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
IOA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
INCONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
CONTROL-V Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
A Schematic View of CONTROL-V Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
CONTROL-V Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Integration With Other INCONTROL Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
CONTROL-V Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
CONTROL-V Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Printers Control Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
IOA Core and CONTROL-V Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Online Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Recipient Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
New Day Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Compressed Dataset Access Method (CDAM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
IOA Archive Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
File Transfer Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
CONTROL-D for Distributed Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
CONTROL-D Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Reporting Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Shout Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Report Decollating Mission Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Report Decollating Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Decollating Workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Balancing Pages Under CONTROL-M/Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Migration, Printing, Backup and Restore Mission Parameters . . . . . . . . . . . . . . . . . . . 57
Migration Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Printing Workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Backup Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Restore Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Online Viewing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Report Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65

Contents 5
 Index Hierarchies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Index Values and Masks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Multi-value indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Indexes, Reports and CDAM Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Index Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Index Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Index Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Using Indexes for Retrieval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Retrieval Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Prerequisite Condition Concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
IOA Calendar Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Date Definition Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
System Date. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Working Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Original Scheduling Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Date Standards and Date Field Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Chapter 2 Online Facilities 77

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
IOA Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
General IOA Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
IOA Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
IOA Primary Option Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Multi-Screen Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Fast Exit From the IOA Online Facility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Screen Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Commands and PFKeys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Online Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
IOA Under ISPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
IOA Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
IOA SET Command Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
IOA TSO Command Processor Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Report Decollating Mission Definition Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Accessing the Report Decollating Mission Definition Facility . . . . . . . . . . . . . . . 109
Creating Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Creating Mission Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Performing Operations on Members and Mission Definitions . . . . . . . . . . . . . . . 110
Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Report Decollating Mission Definition Job List . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Report Decollating Mission Definition Category List . . . . . . . . . . . . . . . . . . . . . 117
Report Decollating Mission Definition Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Editing Mission Definitions in the Edit Environment . . . . . . . . . . . . . . . . . . . . . . 133
Exiting the Report Decollating Mission Definition Screen . . . . . . . . . . . . . . . . . . 134
Ordering Report Decollating Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Copying Report Decollating Mission Definitions to Another Member . . . . . . . . 138
Migration, Printing, Backup, Restore Mission Definition Facility . . . . . . . . . . . . . . . 140
Accessing the Migration, Printing, Backup, Restore Mission Definition Facility. . .
140
Creating Missions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141

6 CONTROL-D and CONTROL-V User Guide

 Creating Mission Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Performing Operations on Missions and Mission Definitions . . . . . . . . . . . . . . . 141
Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Migration, Printing, Backup, Restore Mission Definition Mission List Screen 147
Migration, Printing, Backup, Restore Mission Definition Category List Screen. .
149
Migration, Printing, Backup, Restore Mission Definition Screen. . . . . . . . . . . . . 152
Editing Mission Definitions in the Edit Environment . . . . . . . . . . . . . . . . . . . . . . 165
Exiting the Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Ordering Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Copying Migration, Printing, Backup, Restore Mission Definitions to Another
Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Recipient Tree Definition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Recipient Tree List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Recipient Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Exiting a Recipient Tree List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
User Reports (Online Viewing) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Using Indexes for Report Retrieval. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Report Lists. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Quick Access Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Values of Index Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Index Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Subindex Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
GIVETO Option Distributing Reports to Other Users . . . . . . . . . . . . . . . . . . . . 236
Printing Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Restoring Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Notepad Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Report Viewing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Editing (Reformatting) Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Tag Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Using the Report Viewing Screen To View AFPDS Reports On 3270 Monitors 278
$SYSDATA Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
CONTROL-D for Distributed Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Specifying an External Destination. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
CONTROL-D External Destinations Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
File Transfer Control for Sites With CONTROL-D/PC . . . . . . . . . . . . . . . . . . . . . . . . 294
CONTROL-D/PC Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Fields of the File Transfer Control Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Transfer Statuses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Options of the File Transfer Control Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Transfer of Index Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
SHOW Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Report Printing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Packet Zoom Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Packet Index Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Tracking and Control Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Format Commands of the Active Missions Screen. . . . . . . . . . . . . . . . . . . . . . . . . 306

Contents 7
 Fields of the Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Specifying Retrieval Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Options of the Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
Why Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Mission Log Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Zoom Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Rerun Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
Print Control Print Plan Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
CONTROL-D Objects Facility. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Accessing the CONTROL-D Objects Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Report Cliques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Resource Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
Clique Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Approval and Subscribe Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Condition and Resource Handling Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
IOA Conditions/Resources Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
IOA Manual Conditions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
IOA Log Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
IOA Log Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
IOA Calendar Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Accessing the IOA Calendar Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Calendar List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
Year List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Copying Years to Another Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Calendar Definition Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Exiting the IOA Calendar Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Utilities Under ISPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
IOA Online Utilities Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
D1: Schedule a Report Decollating Mission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
D2: Schedule a Printing Mission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
D3: Schedule a Backup / Migration Mission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
D4: Schedule a Restore Mission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
I1: Add, Check, or Delete a Prerequisite Condition . . . . . . . . . . . . . . . . . . . . . . . . 415

Chapter 3 Decollating Mission Parameters 417

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Report Decollating Mission Definition Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
Basic Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
Runtime Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
Post-Processing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
Decollating Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
CATEGORY: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
CONFCAL: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
DATES: Basic Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
DAYS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
DESC: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448

8 CONTROL-D and CONTROL-V User Guide

DO Statement: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
DO BACKUP: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
DO COND: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
DO CTBRULE: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
DO INDEX: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
DO LEVEL: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
DO MIGRATE: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
DO NAME: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
DO NOTOK: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
DO PRINT: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
DO REMARK: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
DO SET: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
DO SHOUT: Post-Processing Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
DO USER: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
DSN: Runtime Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
GENERIC: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
GROUP: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
IN: Runtime Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
INTERVAL: Runtime Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
JOB DEFAULTS COPIES: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
JOB DEFAULTS DEST: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
JOB DEFAULTS LVL: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
JOB DEFAULTS MAX COPIES: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . 540
JOB DEFAULTS USER: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
JOBID: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
JOBNAME: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
MAXWAIT: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
MINIMUM: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
MONITOR: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
MONTHS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
MQ: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
ON Statement: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
ON Statement Defaults: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572
OUT: PostProcessing Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
OWNER: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
PDS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
PRINT/CDAM PARMS: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
PRIORITY: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
RETRO: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
SET: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
SHOUT: Post Processing Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
TASKTYPE: General Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
TIME: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
WDAYS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
WHEN: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
WHEN IN QUEUE/CLS: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . 628

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 633

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635

Contents 9
 Parameter Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639
General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641
Bundling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
Basic Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
Runtime Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
Post-Processing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
Mission-Specific Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646
Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647
# OF DAYS TO KEEP: Mission Specific Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . 648
# OF GENERATIONS TO KEEP: Mission specific Parameter. . . . . . . . . . . . . . . . . . . 650
BATCH: Mission Specific Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
CATEGORY: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654
CENTERA RETENTION CLASS: Mission-specific Parameter . . . . . . . . . . . . . . . . . . 657
General information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657
Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658
CONFCAL: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
DATES: Basic Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662
DAYS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664
DESC: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 674
GROUP: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676
IN: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679
INCLUDE/EXCLUDE USER: Printing Mission Bundling Parameter . . . . . . . . . . . . 682
INTERVAL: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684
MAXWAIT: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686
MINIMUM: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689
MISSION: General Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691
MONITOR: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693
MONTHS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695
NOT LATER THAN: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . 697
ON LINE# : Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699
ON PAGE# : Runtime Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
OUT: Post-processing Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702
OVERRIDE: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
OWNER: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708
PDS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710
PRINTER: Mission-specific Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712
PRIORITY: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715
RETENTION DAYS: Mission-specific Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717
RETRO: Basic Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719
SECONDARY SKELETON: Mission-specific Parameter . . . . . . . . . . . . . . . . . . . . . . . 722
SHOUT: Post-Processing Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724
SORT: Printing Mission Bundling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729
STAGE: Mission-specific Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733
STORE: Mission-specific Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736
TASKTYPE: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738
TIME: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741
TIMEOUT: Mission-specific Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744
WDAYS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 746

10 CONTROL-D and CONTROL-V User Guide

Chapter 5 Compressed Dataset Access Method (CDAM) 755
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756
How to Use CDAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759
Activating the CDAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759
CDAM Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760
Parameter DSN of the DD Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773
CDAM Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775
CDAM Dataset Naming Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776
Multijob CDAM Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777
CDAM User Exit CTDX018 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779
Example 1. Order a Report Decollating Mission . . . . . . . . . . . . . . . . . . . . . . . . . . 780
Example 2. Add Lines to the Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780
Example 3. Split a Report by Lines (Decollate by Line). . . . . . . . . . . . . . . . . . . . . 781
CDAM Maintenance Utility CTDAMUTI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 781
Activating the Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 782
Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 782
Migrated CDAM Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785
IOA Archive Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785
Media and Resource Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785
OSS Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786
FTK Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786
CART Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787

Chapter 6 Implementation Hints 789

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791
Defining the Recipient Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791
Defining the Levels of the Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791
Defining Report Recipients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793
Recipient Tree Recommendations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794
Report Decollating Missions and the Use of the Recipient Tree . . . . . . . . . . . . . 795
Defining the Recipient Tree Operations Control Subtree . . . . . . . . . . . . . . . . . . . 802
Recipient Tree and Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803
Decollation Without the Recipient Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803
Decollating Criteria Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805
Report Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805
Decollation of Report Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807
Decollation of XML Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 817
Indexing Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 820
Report Design. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 820
Index Design. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 821
Migrated vs. DASD-resident Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822
Naming Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822
Index Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824
Using Indexes for Retrieval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825
Testing Indexes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825
Printing Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 826
Printing Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 826

Contents 11
 Using OUTPARM for Global Control of Printing Characteristics . . . . . . . . . . . . 830
Controlling the Printing Sequence. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 830
Workload Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831
Weekend Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831
Report Decollating Missions and Printing Missions The Link. . . . . . . . . . . . . . 831
Specifying Report Destination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 832
Sending Entire User Bundle to a Specific Destination . . . . . . . . . . . . . . . . . . . . . . 832
Sending Specific Reports to Specific Destinations . . . . . . . . . . . . . . . . . . . . . . . . . 832
Sending Reports to the Original Destination from Spool . . . . . . . . . . . . . . . . . . . 833
Sending Reports to a Specific Destination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833
Sending Reports to a Specific External Writer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833
Sending Unidentified Pages to a Specific Destination . . . . . . . . . . . . . . . . . . . . . . 833
Destination CONTROL-V Search Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833

Appendix A Editing Mission Definitions in the IOA Edit Environment 835

Line Editing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837
Maintaining Valid Mission Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 838

Appendix B Shout Facility Variables 847

System Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 847

Index 851

12 CONTROL-D and CONTROL-V User Guide

Figures
CONTROL-V Operations Schematic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
New Day Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Printing Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Migration Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Online Viewing Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Decollating Jobs Prerequisite Conditions Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
IOA Editor Edit Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
IOA Primary Option Menu when only CONTROL-V is Installed . . . . . . . . . . . . . . . 86
IOA Primary Option Menu when all INCONTROL Products
are Installed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
IOA Version Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
IOA Log Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
PFKey Assignment Widow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
IOA Help Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
IOA Editor Edit Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
IOA Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
IOA SET Command Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
IOA TSO Command Processor Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Report Decollating Mission Definition Facility Entry Panel . . . . . . . . . . . . . . . . . . . . 112
Report Decollating Mission Definition Facility Entry Panel
Search Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
Report Decollating Mission Definition Facility Job List Screen . . . . . . . . . . . . . . . . . 115
Report Decollating Mission Definition Facility Delete Members
Confirmation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
Report Decollating Mission Definition Category List Screen . . . . . . . . . . . . . . . . . 118
Report Decollating Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
Non-Display of Scheduling Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Report Decollating Mission Definition Screen Path Command . . . . . . . . . . . . . . . 124
General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Basic Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Runtime Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Post-Processing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Decollating Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Entering Editing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
The Report Decollating Mission Definition Exit Option Window . . . . . . . . . . . . . . . 136
Order and Force Confirmation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
The CONTROL Report Order Message Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
Window for Copying Decollating Mission Definitions to Another Member . . . . . . 139
Printing, Backup, Restore Mission Definition Facility Entry Panel . . . . . . . . . . . . . . 143
Printing, Backup, Restore Mission Definition Facility Search Window . . . . . . . . . . 146

Figures 13
 Printing, Backup, Restore Mission Definition Mission List Screen . . . . . . . . . . . . . 147
Migration, Printing, Backup, Restore Mission Definition Facility
Delete Confirmation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Migration, Printing, Backup, Restore Mission Definition
Category List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
Migration Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
Printing Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
Backup Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156
Restore Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Bundling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Basic Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Runtime Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Post-Processing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Printing Mission Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Batch Printing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Migration Missions in the Migration, Printing, Backup, Restore
Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Backup Mission Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Entering Edit Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
Saving Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Order and Force Confirmation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
CONTROL-D Mission Order Message Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Window for Copying Mission Definitions to Another Mission . . . . . . . . . . . . . . . . . 170
Recipient Tree Facility Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Recipient Tree List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
Recipient Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Recipient Tree List Screen Exit Option Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
Report Access Using Index Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
User Reports Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187
User Reports Show Option window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
User Reports Entry Panel (Display Type A) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
CONTROL-V User Reports Entry Panel (Display Type J) . . . . . . . . . . . . . . . . . . . . . 196
User Reports Report Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
User Report List Display Type D (Default) Permanent List . . . . . . . . . . . . . . . . . . . 201
User Report List Display Type D (Default) History List . . . . . . . . . . . . . . . . . . . . . 201
User Report List Display Type D (Default) Active List . . . . . . . . . . . . . . . . . . . . . . 201
User Report List Display Type D Additional Info Permanent List . . . . . . . . . . . 203
User Report List Display Type D Additional Info History List . . . . . . . . . . . . . . 203
User Report List Display Type D Additional Info Active List . . . . . . . . . . . . . . . 203
User Report List Display Type U (User) Permanent List . . . . . . . . . . . . . . . . . . . . . 205
User Report List Display Type U (User) History List . . . . . . . . . . . . . . . . . . . . . . . . 205
User Report List Display Type U (User) Active List . . . . . . . . . . . . . . . . . . . . . . . . . 205
User Report List Display Type U Additional Info Permanent List . . . . . . . . . . . 207
User Report List Display Type U Additional Info History List . . . . . . . . . . . . . . 207
User Report List Display Type U Additional Info Active List . . . . . . . . . . . . . . . 207
User Report List Display Type Job (J) History List . . . . . . . . . . . . . . . . . . . . . . . . . . 209
User Report List Display Type Job (J) Active List . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
User Report List Display Type S (SDSF) History List . . . . . . . . . . . . . . . . . . . . . . . . 211

14 CONTROL-D and CONTROL-V User Guide

User Report List Display Type S (SDSF) Active List . . . . . . . . . . . . . . . . . . . . . . . . 211
User Report List Display Type L (Long) Permanent List . . . . . . . . . . . . . . . . . . . . . 212
User Report List Display Type L (Long) History List . . . . . . . . . . . . . . . . . . . . . . . . 213
User Report List Display Type L (Long) Active List . . . . . . . . . . . . . . . . . . . . . . . . 213
User Report List Display Type L Additional Info Permanent List . . . . . . . . . . . 214
User Report List Display Type L Additional Info History List . . . . . . . . . . . . . . 214
User Report List Display Type L Additional Info Active List . . . . . . . . . . . . . . . 214
User Reports List Display Type A (All Fields) Permanent List . . . . . . . . . . . . . . . 215
User Reports List Display Type A (All Fields) History List . . . . . . . . . . . . . . . . . . 215
User Reports List Display Type A (All Fields) Active List . . . . . . . . . . . . . . . . . . . 215
User Report List Display Type A Additional Info History List . . . . . . . . . . . . . . 218
User Report List Display Type A Additional Info Active List . . . . . . . . . . . . . . . 218
User Report Search Continuation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 220
SORT PARAMETERS Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224
Quick Access Report List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226
Quick Access Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
Values of Index Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Values of Index Panel Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Index Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Subindex Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
GIVE TO Option Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Print Option Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Restore Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
General Note Window Browse Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
General Note Window Edit Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
General Note Window Exit Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Report Viewing Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
Selected Pages Print Option Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 252
Report Editing (Ruler) Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Ruler Selection Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Edit Lines and Columns on the Report Editing (Ruler) Screen . . . . . . . . . . . . . . . . . 255
Edit Lines and Columns on the Report Editing (Ruler) Screen Example . . . . . . . 257
Edit Lines and Columns on the Report Editing (Ruler) Screen Example Results 258
Dynamic Extraction Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 260
Dynamic Extraction Parameter Example Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
CONTROL-D Column Editing Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
Column Editing (Reformatting) Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
Column Editing (Reformatting) Example Result . . . . . . . . . . . . . . . . . . . . . . . . . . . 266
Include Lines Based on Strings on the Report Editing (Ruler) Screen . . . . . . . . . . . 267
Color Lines Based On Strings Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Color Lines Based on Strings Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 273
Ruler Definition Environment Exit Option Window . . . . . . . . . . . . . . . . . . . . . . . . . . 274
Tag Note Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
User Reports Entry Panel Values to Produce $SYSDATA
Records in CONTROL-V Migrated Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
$SYSDATA Short Format for History List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 280
$SYSDATA Short Format for Active List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
$SYSDATA Long Format for History List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
$SYSDATA Long Format for Active List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282

Figures 15
 Migrated Report List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
Print Window Specifying an External Destination . . . . . . . . . . . . . . . . . . . . . . . . . . 287
CONTROL-D External Destinations Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 288
CONTROL-D External Destinations, Additional Information Example . . . . . . . . 292
CONTROL-D External Destinations Copy Confirmation Window . . . . . . . . . . . . . . 293
CONTROL-D External Destinations Delete Confirmation Window . . . . . . . . . . . . . 294
File Transfer Control Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
CONTROL-D/PC Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
File Transfer for Control Show Option Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
File Transfer Control Screen Confirm Print Window . . . . . . . . . . . . . . . . . . . . . . . . . 300
CONTROL-D Packet Zoom Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
CONTROL-D Packet Index Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Active Missions Environment Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Active Missions Screen Show Option Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Active Missions Why Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
Active Mission Why Screen Add Confirmation Window . . . . . . . . . . . . . . . . . . . . . . 314
Active Missions Messages Log Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Report Decollating Mission Zoom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
Migration Mission Zoom Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Printing Mission Zoom Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318
Backup Mission Zoom Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Restore Mission Zoom Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
Modifying Mission Parameters in the Zoom Screen . . . . . . . . . . . . . . . . . . . . . . . . . . 320
Zoom Screen EXIT Option Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
Active Missions Environment Rerun Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
Print Plan Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Skip to Report Confirm Override Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
Skip Selection Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
Stop at Report Confirm Override Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
CONTROL-D Objects Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
CONTROL-D Reports Cliques Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
CONTROL-D Reports Cliques List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Reports Cliques Select Format Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332
CONTROL-D Report Clique Screen for Text Reports . . . . . . . . . . . . . . . . . . . . . . . . 332
CONTROL-D Report Clique Screen for AFP Reports . . . . . . . . . . . . . . . . . . . . . . . . 334
CONTROL-D Report Clique Screen for Xerox Reports . . . . . . . . . . . . . . . . . . . . . 336
CONTROL-D Report Clique Screen for PDF Reports . . . . . . . . . . . . . . . . . . . . . . . 337
CONTROL-D Report Clique Save Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
CONTROL-D Resource Sets Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
CONTROL-D Resource Sets List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
CONTROL-D Resources List Screen for Resource Sets . . . . . . . . . . . . . . . . . . . . . . . . 357
CONTROL-D Resources Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
CONTROL-D Resources List for Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
CONTROL-D Resources Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
CONTROL-D Resources List for Clique Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
CONTROL-D Approvals and Subscribe Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . 363
CONTROL-D Approvals and Subscribe Object List . . . . . . . . . . . . . . . . . . . . . . . . . . 365
IOA Conditions/Resources Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
IOA Conditions/Resources COND Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370

16 CONTROL-D and CONTROL-V User Guide

IOA Conditions/Resources DELETE Confirmation Window . . . . . . . . . . . . . . . . . . 372
IOA Conditions/Resources CHANGE Option Window . . . . . . . . . . . . . . . . . . . . . . 373
IOA Manual Conditions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
IOA Manual Conditions Screen NEW COND Window . . . . . . . . . . . . . . . . . . . . . . . 377
IOA Manual Conditions Screen ERASE Confirmation Window . . . . . . . . . . . . . . . . 378
IOA Log Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
IOA Log Screen Display Filters Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
IOA Log Show Screen Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
IOA Log Show Screen Window at Sites where Multiple
INCONTROL Products are Active . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 389
IOA Calendar Facility Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Calendar List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
Year List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 395
Calendar List Screen Copy Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Calendar Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Use of Reserved String ==PERIODIC== . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 401
Periodic Calendar Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Periodic Calendar Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
Calendar List Screen Delete Confirmation Window . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Year List Screen Exit Option Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
IOA Online Utilities Menu when all INCONTROL Products are Installed . . . . . . . 408
Report Decollating Mission Scheduling Utility Screen . . . . . . . . . . . . . . . . . . . . . . . . 409
Print Mission Scheduling Utility Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
Backup Mission Scheduling Utility Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
Restore Mission Scheduling Utility Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Prerequisite Condition Utility Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 415
Report Decollating Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Report Decollating Mission Definition Screen (continued) . . . . . . . . . . . . . . . . . . . . 420
CATEGORY Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
CATEGORY Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
CONFCAL Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
CONFCAL Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 435
DATES Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
DATES Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
DAYS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
DAYS Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
DAYS Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 443
DAYS Parameter Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
DAYS Parameter Example 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 444
DAYS Parameter Example 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
DAYS Parameter Example 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 445
DAYS Parameter Example 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
DAYS Parameter Example 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
DAYS Parameter Example 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
DAYS Parameter Example 10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
DESC Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
DESC Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
DO Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
DO BACKUP Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452

Figures 17
 DO BACKUP Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
DO COND Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
DO COND Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
DO CTBRULE Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
DO CTBRULE Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
DO INDEX Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
DO INDEX Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473
DO INDEX Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474
DO INDEX Parameter Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 476
DO INDEX Parameter Example 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
DO INDEX Parameter Example 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
DO INDEX Parameter Example 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477
DO INDEX Parameter Example 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
DO INDEX Parameter Example 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 479
DO LEVEL Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
DO MIGRATE Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
DO MIGRATE Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
DO NAME Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
DO NAME Parameter, Name Generation by Concatenation Example 4 . . . . . . . . 488
DO NAME Parameter, Name Generation by Concatenation Example 5 . . . . . . . . 489
DO NOTOK Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
DO NOTOK Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
DO PRINT Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
DO PRINT Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 493
DO REMARK Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
DO REMARK Parameter Example 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 499
DO SET Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
DO SHOUT Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
DO SHOUT Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 512
DO USER Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
DO USER Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 520
DO USER Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
DO USER Parameter Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
DSN Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
DSN Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 523
GENERIC Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
GROUP Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
GROUP Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
IN Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
IN Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
IN Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 531
INTERVAL Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
INTERVAL Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
JOB DEFAULTS COPIES Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
JOB DEFAULTS COPIES Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
JOB DEFAULTS DEST Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
JOB DEFAULTS DEST Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537
JOB DEFAULTS LVL Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
JOB DEFAULTS LVL Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539

18 CONTROL-D and CONTROL-V User Guide

JOB DEFAULTS MAX COPIES Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
JOB DEFAULTS MAX COPIES Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541
JOB DEFAULTS USER Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
JOB DEFAULTS USER Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543
JOBID Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
JOBID Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545
JOBNAME Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
JOBNAME Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547
MAXWAIT Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
MAXWAIT Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550
MAXWAIT Parameter Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
MINIMUM Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
MINIMUM Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553
MONITOR Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
MONITOR Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
MONTHS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
MONTHS Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557
MQ Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
MQ Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559
ON Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
ON CLASS Example Decollation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
ON DSN Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566
ON SYSDATA Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567
ON SYSOUT Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568
ON TRNCLASS Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569
ON TRNDSN Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 570
ON TRNDSN Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
ON Statement Default Decollation and Printing Values Format . . . . . . . . . . . . . . . . 572
ON Statement Default Decollation and Printing Values Example 1 . . . . . . . . . . . 576
ON Statement Default Decollation and Printing Values Example 2 . . . . . . . . . . . 577
OUT Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
OUT Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
OWNER Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
OWNER Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
PDS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
PDS Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
PRINT/CDAM PARMS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
PRINT/CDAM PARMS Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
PRIORITY Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
PRIORITY Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593
RETRO Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
RETRO Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 595
RETRO Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
Set Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
SHOUT Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
SHOUT Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
TASKTYPE Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
TASKTYPE Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606
TIME Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

Figures 19
 TIME Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
TIME Parameter Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 609
WDAYS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
WDAYS Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
WDAYS Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
WDAYS Parameter Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
WDAYS Parameter Example 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
WDAYS Parameter Example 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
WDAYS Parameter Example 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
WDAYS Parameter Example 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
WDAYS Parameter Example 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617
WDAYS Parameter Example 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
WDAYS Parameter Example 10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
WHEN Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
WHEN Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626
WHEN Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627
WHEN IN QUEUE/CLS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
WHEN IN QUEUE/CLS Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630
WHEN IN QUEUE/CLS Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630
WHEN IN QUEUE/CLS Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
WHEN IN QUEUE/CLS Example 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632
Migration Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636
Printing Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637
Backup Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638
Restore Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638
# OF DAYS TO KEEP Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648
# OF DAYS TO KEEP Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649
# OF GENERATIONS TO KEEP Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . 650
# OF GENERATIONS TO KEEP Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . 651
BATCH Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
BATCH Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653
CATEGORY Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654
CATEGORY Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 656
RETENTION CLASS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 657
CENTERA RETENTION CLASS Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 658
CONFCAL Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
CONFCAL Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 661
DATES Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662
DATES Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663
DAYS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664
DAYS Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669
DAYS Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 669
DAYS Parameter Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670
DAYS Parameter Example 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 670
DAYS Parameter Example 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671
DAYS Parameter Example 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671
DAYS Parameter Example 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672
DAYS Parameter Example 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 672
DAYS Parameter Example 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673

20 CONTROL-D and CONTROL-V User Guide

DAYS Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673
DESC Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 674
DESC Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 675
GROUP Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676
GROUP Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678
IN Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679
IN Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
IN Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
INCLUDE/EXCLUDE USER Parameters Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . 682
INCLUDE/EXCLUDE USER Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . 683
INTERVAL Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684
INTERVAL Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685
MAXWAIT Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686
MAXWAIT Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 688
MINIMUM Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689
MINIMUM Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
MISSION Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691
MISSION Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692
MONITOR Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693
MSSION Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694
MONTHS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695
MONTHS Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 696
NOT LATER THAN Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697
NOT LATER THAN Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698
ON LINE# Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699
ON PAGE# Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
ON PAGE# Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 701
OUT Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702
OUT Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 705
OVERRIDE Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
OVERRIDE Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707
OWNER Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708
OWNER Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709
PDS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710
PDS Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 711
PRINTER Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712
PRINTER Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 714
PRIORITY Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715
PRIORITY Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 716
RETENTION DAYS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717
RETENTION DAYS Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 718
RETRO Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719
RETRO Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720
RETRO Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721
SECONDARY SKELETON Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722
SECONDARY SKELETON Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723
SHOUT Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724
SHOUT Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728
SORT Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729

Figures 21
 Sort Order in a Recipient Tree Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 731
SORT Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732
STAGE Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733
STAGE Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 735
STORE Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736
TASKTYPE Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738
TASKTYPE Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740
TIME Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741
TIME Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 742
TIME Parameter Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743
TIMEOUT Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744
TIMEOUT Parameter Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 745
WDAYS Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 746
WDAYS Parameter Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751
WDAYS Parameter Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751
WDAYS Parameter Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751
WDAYS Parameter Example 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752
WDAYS Parameter Example 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 752
WDAYS Parameter Example 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753
WDAYS Parameter Example 7 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753
WDAYS Parameter Example 8 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753
WDAYS Parameter Example 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754
WDAYS Parameter Example 10 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 754
CONTROL-V Basic Report Processing Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756
CONTROL-V Report Workflow Using the Compressed Dataset Access Method . 758
Defining Decollation Criteria and Use of the Recipient Tree
Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 796
Defining Decollation Criteria and Use of the Recipient Tree
Primitive Method Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 797
Defining Decollation Criteria and Use of the Recipient Tree
Better Method Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 798
Defining Decollation Criteria Example 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 799
Use of User Exit CTDX016 Example 5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 800
Use of User Exit CTDX016, Alternate Solution Example 5 . . . . . . . . . . . . . . . . . . . . 800
Defining Decollation Criteria and Use of the Recipient Tree
Primitive Method Example 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 801
Defining Decollation Criteria and Use of the Recipient Tree
Better Method Example 6 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 802
JCL Output Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807
Print Stream Displayed in Raw Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 808
Print Stream Displayed in Print Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 808
Print Stream Report Page Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814
Edit Environment in The Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . 835
Example 1 - Inserting Additional DO Statement - Before . . . . . . . . . . . . . . . . . . . . . . 839
Example 1 - Inserting Additional DO Statement - After . . . . . . . . . . . . . . . . . . . . . . . 840
Example 2 - Use of Delete Block Command - Before . . . . . . . . . . . . . . . . . . . . . . . . . . 841
Example 2 - Use of Delete Block Command - After . . . . . . . . . . . . . . . . . . . . . . . . . . . 841
Example 3 - Use of Multiple Move Command - Before . . . . . . . . . . . . . . . . . . . . . . . . 842
Example 3 - Use of Multiple Move Command - After . . . . . . . . . . . . . . . . . . . . . . . . . 843

22 CONTROL-D and CONTROL-V User Guide

Example 4 - Use of Multiple Copy Command - Before . . . . . . . . . . . . . . . . . . . . . . . . 843
Example 4 - Use of Multiple Copy Command - After . . . . . . . . . . . . . . . . . . . . . . . . . 844
Example 5 - Use of Insert Command - Before . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845
Example 5 - Use of Insert Command - After . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 845

Figures 23
24 CONTROL-D and CONTROL-V User Guide
Tables
List of INCONTROL Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Index Value Specification Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Prerequisite Condition Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Regular Calendar Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Gregorian Date Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Gregorian Date Standards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Julian Date Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Prefixing Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Masking Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
INCONTROL Shared IOA Functions and Facilities . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
CONTROL-V Functions and Facilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
IOA Primary Option Menu Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
IOA Transfer Control Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Basic IOA Screen Areas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Command PFKey Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
Additional Key Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Scrolling Amounts in the SCROLL Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
ISPF Command Definitions for PFKeys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
PFKey Functions Within the IOA Editor Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
IOA Editor Command Line Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
IOA Editor Row Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
Report Decollating Mission Definition Facility Screens . . . . . . . . . . . . . . . . . . . . . . . 109
Options of the Job List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Commands of the Category List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
Options of the Category List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
CAPS Command Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Parameters and Subparameters Accepting Lowercase Values . . . . . . . . . . . . . . . . . 122
General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Basic Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Runtime Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
Post-Processing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
Default Decollating Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
ON Statement Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
ON Statement Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
WHEN Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Commands for Exiting the Report Decollating Mission
Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
Options for Ordering Report Decollating Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
Fields in the Window for Copying Mission Definitions to
Another Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139

Tables 25
 Printing, Backup, Restore Mission Definition Facility Screens . . . . . . . . . . . . . . . . . . 140
Options of the Mission List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
Commands of the Category List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
Options of the Category List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
Bundling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
Runtime Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Post-Processing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 160
Printing Mission Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
Batch Printing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Override Values for Printing Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
Migration Mission Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
Backup Mission Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164
Exiting the Mission Definition Screen Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Options for Ordering Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
Fields in the Window for Copying Mission Definitions to
Another Mission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170
Fields in the Window for Copying Mission Definitions to Another Mission . . . . . . 172
Parameters of the Recipient Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Options of the Recipient Tree List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Recipient Tree List Screen Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175
Recipient Definition Screen Required Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Recipient Definition Screen Optional Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 177
Recipient Definition Screen PC Download Parameters . . . . . . . . . . . . . . . . . . . . . . 177
Quick Access Panel Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Methods for Specifying Index Values for Report Retrieval . . . . . . . . . . . . . . . . . . . . 183
User Reports Entry Panel Fields (Display Type V) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Show Options Window Selection Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
User Reports Show Option Window Select by Status Parameters . . . . . . . . . . . . . 193
User Reports Show Option Window Display Option . . . . . . . . . . . . . . . . . . . . . . . . 193
User Reports Entry Panel Sections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
Consolidated Index Value Search Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
User Report List Header Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
Fields in the Default (D) Display Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Additional Info Fields in the Default (D) Display Type . . . . . . . . . . . . . . . . . . . . . . . 203
Fields in the User (U) Display Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206
Additional Info Fields in the User (U) Display Type . . . . . . . . . . . . . . . . . . . . . . . . . . 208
Fields in the Job (J) Display Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 209
Additional Info Fields In the Job (J) Display Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
Fields in the SDSF (S) Display Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
Additional Info Fields in the S (SDSF) Display Type . . . . . . . . . . . . . . . . . . . . . . . . . . 212
Fields in the Long (L) Display Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 213
Fields in the All Fields (A) Display Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216
Additional Info Fields in the All Fields (A) Display Type . . . . . . . . . . . . . . . . . . . . . 218
User Report List STATUS Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219
Options of the User Report List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
User Report List General Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
SORT PARAMETERS Window Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 224

26 CONTROL-D and CONTROL-V User Guide

STORE Command Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 225
Fields in the Quick Access Report List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Fields of the Quick Access Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
Commands of the Quick Access Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
PFKeys for the Quick Access Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Fields of the Values of Index Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Options of the Values of Index Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
Fields of the Index Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 234
Options of the Index Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
Fields of the Subindex Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
Options of the Subindex Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 236
GIVE TO Option Window Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 237
Print Option Window Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Print Option Window Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 239
Notepad Facility Note Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
N (Note) Field Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Note Window Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 244
Header Fields in the Report Viewing Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
Report Viewing Screen Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
Report Editing (Ruler) Screen Selection Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Options for Edit Lines on the Report Editing (Ruler) Screen . . . . . . . . . . . . . . . . . . . 256
Color Codes for Color Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263
Highlight Codes for Hilite Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Color Codes for Line Range Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 269
Highlight Codes for Line Range Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
ON STR Line Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
Color Line for Color Lines Based on Strings Screen . . . . . . . . . . . . . . . . . . . . . . . . . . 272
RULER Command Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 275
Fields in the $SYSDATA Short Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
Fields in the Active and History Report $SYSDATA Long Format . . . . . . . . . . . . . 282
$SYSDATA Printing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Primary Migrated CDAM Fields Migrated Report List . . . . . . . . . . . . . . . . . . . . . . 284
Migration Log Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
Options of the $SYSDATA List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Screens in which an External Destination Can be Specified . . . . . . . . . . . . . . . . . . . . 286
Header Fields in the CONTROL-D External Destinations Screen . . . . . . . . . . . . . . . 288
Options of the CONTROL-D External Destinations Screen . . . . . . . . . . . . . . . . . . . . 289
CONTROL-D External Destinations Additional Information . . . . . . . . . . . . . . . . . 290
CONTROL-D External Destinations Copy Confirmation Window . . . . . . . . . . . . . 292
CONTROL-D External Destinations Delete Confirmation Window . . . . . . . . . . . . 294
Fields of the Transfer Control Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Transfer Statuses of the File Transfer Control Screen . . . . . . . . . . . . . . . . . . . . . . . . . 297
States that may Appear as Part of a Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Options of the File Transfer Control Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
File Transfer for Control Show Option Window Selection Criteria . . . . . . . . . . . . . 299
File Transfer Control Screen Confirm Print Window Fields . . . . . . . . . . . . . . . . . . . 300
Fields of the CONTROL-D Packet Zoom Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Fields of the CONTROL-D Packet Index Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
Default Colors for Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 305

Tables 27
 Commands of the Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Fields of the Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Mission Statuses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307
Active Missions Screen Show Option Window Search Criteria . . . . . . . . . . . . . . . . . 310
Options of the Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Active Mission Why Screen Add Confirmation Window Fields . . . . . . . . . . . . . . . . 314
Active Missions Zoom Screen Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Zoom Screen Fields Not on the Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . 316
Print Plan Screen Header Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Report Fields in the Print Plan Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
Print Control Options of the Print Plan Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
Report Clique Selection Criteria Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
Options of the CONTROL-D Reports Cliques List . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
Common Report Clique Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
Parameters Unique to Advanced Function Presentation (AFP) Report Cliques . . . 346
General ParametersUnique to Text Report Cliques . . . . . . . . . . . . . . . . . . . . . . . . . 348
Decollation ParametersUnique to Text Report Cliques . . . . . . . . . . . . . . . . . . . . . . 349
Rendering ParametersUnique to Text Report Cliques . . . . . . . . . . . . . . . . . . . . . . . 350
Parameters Unique to Xerox Report Cliques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 351
Exiting the Report Clique Definition Screen Commands . . . . . . . . . . . . . . . . . . . . . . 353
Resource Sets Selection Criteria Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355
Options of the CONTROL-D Resource Sets List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
Options of the CONTROL-D Resource Sets List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 357
Resources Selection Criteria Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 359
Options of the CONTROL-D Resources List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Clique Resources Selection Criteria Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
Options of the CONTROL-D Resources List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 362
Approvals and Subscribe Object Selection Criteria Fields . . . . . . . . . . . . . . . . . . . . . 364
Approvals and Subscribe Object List Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 365
Options of the CONTROL-D Approvals and Subscribe Object List . . . . . . . . . . . . . 365
Fields of the IOA Conditions/Resources Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
IOA Conditions/Resources Retrieval Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
IOA Conditions/Resources ADD Command Formats . . . . . . . . . . . . . . . . . . . . . . . . 371
Options of the IOA Conditions/Resources Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 371
IOA Conditions/Resources DELETE Confirmation Window Options . . . . . . . . . . . 372
COUNT Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
Fields of the IOA Manual Conditions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
Retrieval Criteria for IOA Manual Conditions Screen . . . . . . . . . . . . . . . . . . . . . . . . . 376
Options of the IOA Manual Conditions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378
Fields of the IOA Manual Conditions Screen ERASE
Confirmation Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
Fields of the IOA Log Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 380
Commands of the IOA Log Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 381
IOA Log Screen Predefined Display Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
Fields of the Display Filters Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Options of the Display Filters window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Fields of the IOA Log Show Screen Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
IOA Log Show Screen Window Selection Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . 387
IOA Log Show Screen Window - Closing Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390

28 CONTROL-D and CONTROL-V User Guide

IOA Calendar Facility Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Fields of the IOA Calendar Facility Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Options of the Calendar List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Commands of the Year list screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
Options of the Year List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 396
Fields of the Calendar List Screen Copy Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Fields of the Calendar Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Commands for Exiting the Calendar Definition Screen . . . . . . . . . . . . . . . . . . . . . . . 405
Fields of the Prerequisite Condition Utility Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . 409
Print Mission Scheduling Utility Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
Backup Mission Scheduling Utility Screen Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412
Restore Mission Scheduling Utility Screen Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
Prerequisite Condition Utility Screen Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 416
Decollating Mission General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
Basic Scheduling Parameter Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424
Runtime Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
Post-Processing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
Decollating Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
CONFCAL Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
DAYS Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
Non-Periodic Scheduling Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 440
Periodic Scheduling Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
DO Parameter Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
DO COND Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
Symbolic Prerequisite Condition Dates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
DO CTBRULE Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
CONTROL-M/Analyzer System Variable SYSOPT Values . . . . . . . . . . . . . . . . . . . . 460
DO INDEX Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 463
Values for JOBNAME in DO INDEX=JOBNAME_DDNAMES Expression . . . . . . 470
DO NAME Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
DO PRINT Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
DO REMARK Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
DO SET Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
DO SHOUT Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
DO USER Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
In Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
JOB DEFAULTS COPIES Subparameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534
JOB DEFAULTS DEST Subparameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
JOB DEFAULTS LVL Subparameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
JOB DEFAULTS MAX COPIES Subparameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 540
JOB DEFAULTS USER Subparameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
Valid JOBID Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
MAXWAIT Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
MQ Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
ON Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
ON Statement Default Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572
OUT Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579
Prerequisite Condition Symbolic Dates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580
RETRO Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594

Tables 29
 SET Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
System variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 598
SHOUT Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
TASKTYPE Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
WDAYS Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
Non-Periodic Scheduling Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612
Periodic Scheduling Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
WHEN Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
Further WHEN Subparameter Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
WHEN IN QUEUE/CLS Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628
CONTROL-V General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641
CONTROL-V Bundling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
Basic Scheduling Parameter Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643
Runtime Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
Post-Processing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646
Mission-Specific Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646
BATCH Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
CONFCAL Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
DAYS Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664
Non-Periodic Scheduling Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 666
Periodic Scheduling Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 667
Use of GROUP Parameter to Override OUTGRP Parameter . . . . . . . . . . . . . . . . . . . 677
IN Prerequisite Condition Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679
MAXWAIT Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686
MONTHS Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695
OUT Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703
OUT Parameter Prerequisite Condition Symbolic Dates . . . . . . . . . . . . . . . . . . . . . . . 704
OVERRIDE Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
PRINTER Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712
RETENTION DAYS Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717
RETRO Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719
SHOUT Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724
SORT Parameter Sort Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729
SORT Order Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 730
STAGE Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733
STORE Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736
TASKTYPE Values Migration Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738
TASKTYPE Values Printing Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738
TASKTYPE Values Backup Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738
TASKTYPE Values Restore Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738
WDAYS Subparameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 746
Non-Periodic Scheduling Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 748
Periodic Scheduling Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749
ACIF Parameter Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763
CDAM Dataset Allocation Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776
CDAM Dataset Naming Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776
Rules Used when Activating utility CTDAMUTI on Multi-Job CDAM Datasets . . 784
Required Fields for Defining Recipients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793
Optional Fields for Defining Recipients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793

30 CONTROL-D and CONTROL-V User Guide

Tree Definition Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794
Subjects for Line Editing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 836
Delete Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837
Copy Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837
Move Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837
Repeat Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 837
Insert Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 838
Location Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 838
System Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 847
AutoEdit System Variables - 4-character years . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 848
AutoEdit System Variables - 2-character years . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 849

Tables 31
32 CONTROL-D and CONTROL-V User Guide
About This Guide
This guide is the basic publication on how to use CONTROL-D and CONTROL-V
software. It is intended for everyone who wants to use CONTROL-D for distribution
and viewing, and CONTROL-V for report indexing and migration. It provides
detailed information on all CONTROL-D and CONTROL-V functions and facilities
and contains the following chapters:

NOTE
All references to the combined functionality of CONTROL-D and CONTROL-V are referred to
in this guide as CONTROL-V. Screens including a D/V reference are occasionally used for
illustration, and in such cases those screens are applicable to both CONTROL-D and
CONTROL-V.

Chapter 1Introduction

Overview of CONTROL-V. CONTROL-V concepts are introduced and the

CONTROL-V environment is described. IOA components and concepts are also
described. It is recommended that all users read this chapter before reading other
chapters of the guide.

Chapter 2Online Facilities

Guide to mission definition, tracking and control using the Online facility.
CONTROL-V and IOA screens are illustrated and discussed in a logical sequence.

Chapter 3Decollating Mission Parameters

Detailed description of CONTROL-V report decollating and indexing mission

parameters, accompanied by examples.

Chapter 4Migration, Printing, Backup and Restore Mission Parameters

Detailed description of CONTROL-V migration, printing, backup and restore mission

parameters, accompanied by examples.

About This Guide 33

Conventions Used in This Guide

Chapter 5Compressed Dataset Access Method

Description of the Compressed Dataset Access Method (CDAM) which enables

CONTROL-V to read and write compressed sequential datasets.

Chapter 6Implementation Hints

Guidelines for implementing CONTROL-V at your site.

Appendix AEditing Mission Definitions in the Edit Environment

Description of the IOA Edit environment and examples illustrating IOA line editing
commands.

Appendix BShout Facility Variables

Description of predefined Shout facility variables whose values are automatically

updated by CONTROL-V when a SHOUT message is issued.

Conventions Used in This Guide

Notational conventions that may be used in this guide are explained below.

Standard Keyboard Keys

Keys that appear on the standard keyboard are identified in boldface, for example,
Enter, Shift, Ctrl+S (a key combination), or Ctrl S (a key sequence).

WARNING
The commands, instructions, procedures, and syntax illustrated in this guide presume that the
keyboards at your site are mapped in accordance with the EBCDIC character set. Certain
special characters are referred to in this documentation, and you must ensure that your
keyboard enables you to generate accurate EBCDIC hex codes. This is particularly true on
keyboards that have been adapted to show local or national symbols. You should verify that

$ is mapped to x'5B'
# is mapped to x'7B'
@ is mapped to x'7C

'If you have any questions about whether your keyboard is properly mapped, contact
your system administrator.

34 CONTROL-D and CONTROL-V User Guide

 Conventions Used in This Guide

Preconfigured PFKeys

Many commands are preconfigured to specific keys or key combinations. This is

particularly true with regard to numbered PF keys, or pairs of numbered PFKeys. For
example, the END command is preconfigured to, and indicated as, PF03/PF15. To
execute the END command, press either the PF03 key or the PF15 key.

Instructions to enter commands may include

only the name of the command, such as, enter the END command
only the PF keys, such as, press PF03/PF15
or both, such as, press PF03/PF15, or enter the END command

Command Lines and Option Fields

Most screens contain a command line, which is primarily used to identify a single
field where commands, or options, or both, are to be entered. These fields are usually
designated COMMAND, but they are occasionally identified as COMMAND/OPT or
COMMAND/OPTION.

Option field headings appear in many screens. These headings sometimes appear in
the screen examples as OPTION, or OPT, or O.

D/V Screens

Screens including a D/V reference are occasionally used for illustration, and in such
cases those screens are applicable to both CONTROL-D and CONTROL-V.

Names of Commands, Fields, Files, Functions, Jobs, Libraries, Members,

Missions, Options, Parameters, Reports, Subparameters, and Users

The names of commands, fields, functions, jobs, libraries, members, missions,

options, parameters, reports, subparameters, users, and most files, are shown in
standard UPPERCASE font.

User Entries

In situations where you are instructed to enter characters using the keyboard, the
specific characters to be entered are shown in this UPPERCASE BOLD text, for
example, type EXITNAME.

Syntax statements

In syntax, the following additional conventions apply:

About This Guide 35

Conventions Used in This Guide

A vertical bar ( | ) separating items indicates that you must choose one item. In the
following example, you would choose a, b, or c:

a | b | c

An ellipsis ( . . . ) indicates that you can repeat the preceding item or items as many
times as necessary.

Square brackets ( [ ] ) around an item indicate that the item is optional. If square
brackets ( [ ] ) are around a group of items, this indicates that the item is optional,
and you may choose to implement any single item in the group. Square brackets
can open ( [ ) and close ( ] ) on the same line of text, or may begin on one line of text
and end, with the choices being stacked, one or more lines later.

Braces ({ }) around a group of items indicates that the item is mandatory, and you
must choose to implement a single item in the group. Braces can open ( { ) and
close ( } ) on the same line of text, or may begin on one line of text and end, with the
choices being stacked, one or more lines later.

Screen Characters

All syntax, operating system terms, and literal examples are

presented in this typeface. This includes JCL calls, code examples, control
statements, and system messages. Examples of this are:

calls, such as
CALL CBLTDLI

code examples, such as

FOR TABLE owner.name USE option, . . . ;

control statements, such as

//PRDSYSIN DD * USERLOAD PRD(2) PRINT

system messages, both stand-alone, such as You are not logged on to

database database_name, and those embedded in text, such as the message
You are not logged on to database database_name, are displayed on
the screen.

36 CONTROL-D and CONTROL-V User Guide

 Information New to This Version

Variables

Variables are identified with italic text. Examples of this are:

In syntax or message text, such as

Specify database database_name
In regular text, such as
replace database database_name1 with database database_name2 for the current
session
In a version number, such as
EXTENDED BUFFER MANAGER for IMS 4.1.xx

Special elements

This book includes special elements called notes and warnings:

NOTE
Notes provide additional information about the current subject.

WARNING
Warnings alert you to situations that can cause problems, such as loss of data, if you do not
follow instructions carefully.

Information New to This Version

Where substantive additions and modifications to the content of this guide occur,
revision bars have been inserted in the margin.

Additional information that is new to this version is described in Appendix C of the

INCONTROL for z/OS Upgrade Guide.

Related Publications
CONTROL-D Getting Started Guide

Explanation of CONTROL-D and CONTROL-V facilities. Online, step-by-step

instructions are provided.

About This Guide 37

Related Publications

CONTROL-D and CONTROL-V Online Viewing Guide

Tutorial guide for the end-user which demonstrates the features of the Online
Viewing facility.

CONTROL-D Planning and Implementation Guide

Practical guide for determining implementation objectives and both planning and
performing the implementation of CONTROL-D.

Implementing AFP in the CONTROL-D Environment

Guide to the efficient utilization of CONTROL-D's built-in AFP support features.

INCONTROL for z/OS Administrator Guide

Information for system administrators about customizing and maintaining

INCONTROL products.

INCONTROL for z/OS Installation Guide

Step-by-step guide to installing INCONTROL products using the INCONTROL

Installation and Customization Engine (ICE) application.

INCONTROL for z/OS Messages Manual

Comprehensive listing and explanation of all INCONTROL and IOA messages and
codes.

INCONTROL for z/OS Security Guide

Step-by-step guide to implementing security in INCONTROL products.

INCONTROL for z/OS Utilities Guide

Describes utilities designed to perform specific administrative tasks that are available
to INCONTROL products.

38 CONTROL-D and CONTROL-V User Guide

 Chapter

1
1 Introduction
This chapter contains the following topics:

INCONTROL Products and IOA. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

IOA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
INCONTROL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
CONTROL-V Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
A Schematic View of CONTROL-V Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
CONTROL-V Capabilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Integration With Other INCONTROL Products . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
CONTROL-V Components. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
CONTROL-V Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Printers Control Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
IOA Core and CONTROL-V Repository . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Online Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Recipient Tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
New Day Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Compressed Dataset Access Method (CDAM) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
IOA Archive Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
File Transfer Monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
CONTROL-D for Distributed Systems. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
CONTROL-D Application Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Reporting Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Shout Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Report Decollating Mission Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
Report Decollating Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Decollating Workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
Balancing Pages Under CONTROL-M/Analyzer . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Migration, Printing, Backup and Restore Mission Parameters . . . . . . . . . . . . . . . . . . . 57
Migration Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Printing Workflow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Backup Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
Restore Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
Online Viewing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
Report Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Index Hierarchies. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Chapter 1 Introduction 39
 Index Values and Masks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
Indexes, Reports and CDAM Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Index Design . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
Index Migration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Index Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Using Indexes for Retrieval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Retrieval Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Prerequisite Condition Concept . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
IOA Calendar Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Date Definition Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
System Date. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Working Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Original Scheduling Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Date Standards and Date Field Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

40 CONTROL-D and CONTROL-V User Guide

 INCONTROL Products and IOA

INCONTROL Products and IOA

The CONTROL-V Quick Access Archive Viewing System is a component member of
the INCONTROL by BMC Software family of products, a fully integrated suite
designed to automate, manage and streamline operations on the OS/390 or z/OS
mainframe. The INCONTROL family also includes client and server products that
facilitate the automation of other platforms.

IOA
The Integrated Operations Architecture (IOA) is at the heart of the INCONTROL
family of products. IOA has a common core of shared code as the foundation of its
architecture design. INCONTROL's IOA environment has several inherent design
advantages, including a common user interface and a shared data repository. A key
feature of the IOA environment is its integrated application design, which includes:

Integrated User Notification

Management by Exception
Integrated Scheduling
Interdependency and Interrelationship Handling
Common Help Facility
Integrated Management Reporting
Common Method for Sharing Information
Unified Installation and Maintenance
Unified Security Implementation
Open Interface Design

INCONTROL
The INCONTROL family of products includes:

Table 1 List of INCONTROL Products (part 1 of 2)

Product Description
CONTROL-M Automated Production Control and Scheduling System
Manages and automates the setup, scheduling and execution
of jobs in the data center.
CONTROL-M/Restart Restart Management System
Automates the activities that must be performed when
restarting failed jobs, including the scratching and
uncataloging of datasets created by failed jobs.

Chapter 1 Introduction 41
CONTROL-V Overview

Table 1 List of INCONTROL Products (part 2 of 2)

Product Description
CONTROL-M/Tape Removable Media Management System
Increases utilization of removable media and controls
retention periods. Prevents misuse of media, and provides
tape library and vault control.
CONTROL-M/Analyzer Automated Information Integrity System
Performs in-stream validation, accuracy, and reasonability
checks on information used by data center production tasks
(for example, reports, databases).
CONTROL-D Output Management System Automatically schedules and
controls every aspect of report processing and distribution,
including report decollating, bundling, printing, online
viewing, and archiving.
CONTROL-V Quick Access Archive Viewing System
Provides online access to archived reports and documents by
indexed data retrieval.
CONTROL-D/ Report Retrieval and Display System
Page On Demand Enables end users to retrieve and view pages of reports that
reside on mainframe storage in real time. Indexed reports can
be retrieved by index name and value. AFP and XEROX
reports can also be retrieved and displayed using
CONTROL-D/Web Access Server or CONTROL-D/Page On
Demand API.
CONTROL-D/ Image Image Output Management System
Enables output from commercial imaging equipment to be
imported into either CONTROL-D or CONTROL-V for
decollation, distribution and viewing, and into CONTROL-V
for archiving and indexed retrieval.
CONTROL-O Console Automation System and Desired State Monitoring
System
Monitors and automatically responds to messages, commands,
and dataset events, as well as various other system events.

The CONTROL-O/COSMOS feature allows for status

monitoring while maintaining all critical system objects in a
desired and ideal status.

CONTROL-V Overview
CONTROL-V is an automated operations product that provides indexing, controlled
migration to various storage media, selective retrieval by index values, and online
viewing of computer generated reports. CONTROL-V replaces the usage of
Computer Output Microfiche (COM) and facilitates productive online report viewing
while efficiently using the most cost effective media for report storage.

42 CONTROL-D and CONTROL-V User Guide

 A Schematic View of CONTROL-V Operation

A Schematic View of CONTROL-V Operation

Figure 1 CONTROL-V Operations Schematic

Reports in conventional and compressed formats are automatically indexed by

decollating missions that assign report pages or sections to appropriate users and
other recipients. The reports and generated indexes can be viewed online before and
after optional transfer to various storage media by migration missions. The indexes
are utilized to quickly select and retrieve relevant report pages and sections.

CONTROL-V Capabilities
CONTROL-V increases the value and decreases the cost of computer generated
information that must be retained for relatively long periods of time by:

Assigning index values to report pages or sections.

Generating alphabetical indexes that can be used to efficiently retrieve report

pages or sections from all popular storage media.

Chapter 1 Introduction 43
Integration With Other INCONTROL Products

Automatically migrating reports and indexes from DASD to more costeffective

long term storage media.

Providing powerful online viewing capabilities that include report editing and a
mechanism for adding notes and comments.

Using the Compressed Dataset Access Method (CDAM) to minimize the space
required for storing reports on any supported media.

Maintaining files that can be easily viewed online to obtain information about
reports, users and CONTROL-V activities.

Enhancing the security and integrity of stored data.

Integrating efficiently with all other INCONTROL products.

All CONTROL-D features are also available. CONTROL-D:

Simultaneously automates the distribution and access control of CONTROL-V

indexed reports, through a hierarchical Recipient Tree.

Enhances CONTROL-Vs printing capabilities with a Print Bundling facility.

Provides additional protection against the loss of essential data with automated
backup and restore facilities.

Transfers reports to PCs using CONTROL-D/WebAccess Server.

Enables reports to be viewed or printed by CONTROL-D/WebAccess Server,

through CONTROL-D/Page On Demand.

Supports predefined indexes of AFP reports that are used through

CONTROL-D/WebAccess Server Page On Demand.

Integration With Other INCONTROL Products

The functions of CONTROL-V can be completely integrated with those of other
INCONTROL automated operations products. The value of all installed
INCONTROL products is enhanced as a result of this integration. Techniques and
procedures learned for one INCONTROL product are easily transferred to the others.
Some specific benefits of INCONTROL product integration for the CONTROL-V user
are:

The CONTROL-V indexing process is performed as part of the CONTROL-D

decollation process, saving both time and computer resources.

44 CONTROL-D and CONTROL-V User Guide

 Integration With Other INCONTROL Products

The CONTROL-D Recipient Tree can be used to automate the distribution and the
access control (security) of CONTROL-V indexed reports.

CONTROL-D report editing rulers and notepad facilities can be used when
viewing CONTROL-Vs reports.

CONTROL-D backup and restore missions are coordinated with CONTROL-V

migration missions to ensure timely backups and eliminate unnecessary data
transfer operations.

CONTROL-M/Analyzer balancing operations can be performed automatically on

CONTROL-V pages.

Reports can be downloaded to PCs by CONTROL-D/WebAccess Server.

The same powerful, user-friendly online facility is used for all electronic report
monitoring, control and viewing.

Prerequisite conditions in the IOA Conditions file and in the IOA Manual
Conditions file can be applied to CONTROL-V operations.

The Compressed Dataset Access Method (CDAM) reduces the space required for
CONTROL-V files wherever they reside.

The IOA Log file keeps a complete audit trail of important messages generated by
all INCONTROL products.

The IOA Reporting facility, including the KeyStroke Language (KSL), can generate
reports about CONTROL-V operations based on data in the IOA Log file and other
sources.

The same accurate, flexible Calendar facility is used by all INCONTROL products.

Chapter 1 Introduction 45
CONTROL-V Components

CONTROL-V Components
The main components of CONTROL-V and their interrelationships are discussed in
the following paragraphs. The components described are:

CONTROL-V monitor
Printers Control monitor
IOA Core and CONTROL-V Repository
Online facility
Recipient Tree
New Day procedure
Compressed Dataset Access Method
IOA Archive Server
File Transfer Monitor
CONTROL-D for Distributed Systems
Application Server
Reporting facility
Shout facility
Utilities

CONTROL-V Monitor
CONTROL-V and CONTROL-D share the same monitor when both are installed.
However, this monitor is referred to as the CONTROL-V monitor in this guide.

The CONTROL-V monitor executes mission (task) instructions defined by the users.
The monitor is active in one computer at the site, usually 24 hours a day. It is
normally activated as a started task.

46 CONTROL-D and CONTROL-V User Guide

 Printers Control Monitor

The monitors primary functions are:

Scheduling missions for execution based on the existence of prerequisite

conditions, scheduling time limits, priorities, and so on.
Decollating reports
Indexing reports during decollation
Preparing printing plans for the Printers Control monitor
Migrating reports
Backing up reports
Restoring reports
Notifying users (for example, TSO users, computer operator) of report events
Adding and deleting prerequisite conditions
Transferring reports to PCs (for users of CONTROL-D/WebAccess Server)

Printers Control Monitor

The Printers Control monitor is active as an independent started task. It is initiated,
controlled and terminated by the CONTROL-V monitor. Its purpose is to actually
perform the printing process.

The Printers Control monitor receives from the CONTROL-V monitor a printing plan
and the name of the printer assigned to the printing mission (printing mission = a
bundle). The Printers Control monitor writes the bundled reports to spool in
controlled chunks (the size of which is specified in the printing mission or in the
Printer Definition in member CTDPARM). It tracks printing speed and makes sure
the printer always has something to print, but not too much. This prevents
overloading the spool with sysouts that cannot be printed until much later.

The Printers Control monitor switches to a new chunk of lines when the printing
characteristics in the user bundle change. It is possible to print sysouts with different
printing characteristics in the same bundle.

IOA Core and CONTROL-V Repository

Files that are shared by INCONTROL products are collectively referred to as the IOA
Core. Files used only by CONTROL-V are collectively called the CONTROL-V
Repository. The CONTROL-V Repository consists of the following files:

Active Missions file

User Report List files
Active Transfer file

Chapter 1 Introduction 47
IOA Core and CONTROL-V Repository

The IOA Core consists of the following files:

IOA Conditions file

IOA Manual Conditions file
IOA Log file
IOA Calendar tables
Dynamic Destination Table

Active Missions File

The Active Missions file contains report decollating missions (including indexing
instructions) for all jobs that need to be decollated in the near future, are currently
decollating. or have recently finished being decollated. It also contains migration,
printing, backup and restore missions. It is a control file used by operations personnel
to query and update the status of report processing tasks (missions).

User Report List Files

The User Report List files contain information on all reports a user can receive at any
time or has received already. They act as a smart index for the users reports,
providing a means for selecting reports, online viewing, and so on.

Active Transfer File

The Active Transfer file contains information about packets that have been scheduled
for transfer to a PC. Packets are automatically created and included in the file if the
report had a destination of CTDPC or CTDPCPRT. This file is only used at sites
working with CONTROL-D/WebAccess Server.

IOA Conditions File

The IOA Conditions file contains a list of prerequisite conditions under the control of
CONTROL-V.

IOA Manual Conditions File

The IOA Manual Conditions file contains a list of all prerequisite conditions that are
expected to be added manually by the CONTROL-V user (for example,
START-MIGRATE, AR-BALANCED).

48 CONTROL-D and CONTROL-V User Guide

 Online Facility

IOA Log File

All messages issued by INCONTROL products are written to the IOA Log file. The
IOA Log file contains a complete audit trail of every event under the CONTROL-V
environment. CONTROL-V logs every item of meaningful information about its
operation, including statistics. The IOA Log screen displays the IOA Log file. The
user can filter IOA Log file contents displayed in the IOA Log screen.

Mission Definition Libraries

Missions are defined as regular members in libraries (partitioned datasets). Usually a
different library is allocated to:

Decollating missions (including indexing instructions)

Migration missions
Printing missions
Backup missions
Restore missions

An unlimited number of libraries can be used (for example, due to security

considerations). More information about defining missions is provided later in this
chapter.

Online Facility
Users of CONTROL-V communicate with the system via the Online facility, a set of
integrated, interactive fill-in-the-blanks screens that provide access to CONTROL-V
information. Its operation is characterized by:

Uniform ISPF-like screen handling conventions

Menu-driven functions
Dynamic PFKey assignment
All information on the screen approach
Concurrent management of many screens (including TSO applications)

Chapter 1 Introduction 49
Recipient Tree

The Online facility allows access to the Repository, to the IOA Core, and to indexes
and compressed reports. It enables the user to see and update the following:

Mission definition parameters

Index definitions
Report copy count, print destination, and so on.
Sections of reports that belong to the user
Status of active missions
Status of prerequisite conditions under the supervision of CONTROL-V
IOA Log file
Calendars

The Online facility can be activated under the following environments, regardless of
whether the CONTROL-V monitor is active:

TSO (native)
TSO/ISPF
IMS/DC
VTAM
ROSCOE/ETSO
IDMS/DC
CICS
COM-PLETE

TSO users can activate other online application programs (including ISPF)
concurrently with the Online facility under the multiplication environment created
by CONTROL-V.

CONTROL-V provides full color support when activated from a screen with
extended seven-color support.

The Online facility is explained in depth in Chapter 2, Online Facilities.

Recipient Tree
The list of all possible report recipients is organized as a tree. The Recipient Tree
allows the users (recipients) to be grouped in a hierarchical structure correlating to
the organizational chart of the recipients in the organization.

The Recipient Tree is defined and maintained by authorized users via the Online
facility. It contains the user name, synonyms, a free text description, and so on. For
sites using CONTROL-D/WebAccess Server, it also contains fields relating to the
downloading of reports to PCs.

50 CONTROL-D and CONTROL-V User Guide

 New Day Procedure

It is possible to minimize the size of the Recipient Tree by listing only recipients
whose entries include special information (for example, recipient's address,
synonyms, CONTROL-D/WebAccess Server authorization, $SYSDATA access,
special default destination). For more information about this topic, see Decollation
Without the Recipient Tree on page 803.

New Day Procedure

The New Day procedure is the primary mechanism used to issue (activate) new
missions for the CONTROL-V monitor. The New Day procedure is activated to
determine which missions may potentially be activated on a specific date. A mission
is not necessarily executed by the monitor. For example, a mission is not executed if it
has prerequisite conditions that have not been satisfied.

The New Day procedure places the potential missions in the Active Missions file. The
monitor reads the new missions from the Active Missions file and merges their data
with the rest of the workload information under its supervision. The monitor
executes the mission while taking into account the entire report distribution
environment.

The New Day procedure is usually activated automatically by the monitor at a

predefined time each day. The New Day procedure can also be activated manually by
a job, TSO CLIST, ROSCOE RPF, or through the Online facility.

Figure 2 New Day Procedure

Chapter 1 Introduction 51
Compressed Dataset Access Method (CDAM)

Compressed Dataset Access Method (CDAM)

CONTROL-V stores sysouts in compressed format using the Compressed Dataset
Access Method (CDAM). This access method allows both CONTROL-V and regular
jobs to write or read reports to/from compressed datasets. The compressed datasets
are regular sequential datasets containing reports in compressed format. They are
automatically managed by the various CONTROL-V components. For more
information about CDAM, see Chapter 5, Compressed Dataset Access Method
(CDAM).

IOA Archive Server

The IOA Archive server provides services for viewing and printing reports migrated
to storage media other than DASD.

CONTROL-V migrates reports in compressed format from DASD to various storage

media, including DASD. Reports migrated to DASD can be viewed without
activating and using the IOA Archive server. Reports and indexes migrated to other
storage media use the IOA Archive server for online viewing and Immediate
Printing.

The IOA Archive server:

Supports various media types based on user definitions.

Responds to operator commands that modify media definitions during server
operation to increase or decrease the service level or free resources for other
jobs.
Permits stopping and starting a media defined to the server without affecting
ongoing work on other media.
Supports concurrent requests to the same or a different media type.
Implements queuing and synchronization mechanisms to optimize service level,
improve media utilization, and reduce volume switch requests.
Provides an internal caching mechanism to reduce media accesses and improve
response time.
Uses cross memory services to communicate with address spaces requesting its
services.

File Transfer Monitor

The File Transfer monitor can be used to transfer CONTROL-D/WebAccess Server
packets from the OS/390 mainframe to the PC. This monitor scans the Active
Transfer file and determines which packets should be transferred.

52 CONTROL-D and CONTROL-V User Guide

 CONTROL-D for Distributed Systems

For more information about the File Transfer monitor, see the CONTROL-D and
CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

CONTROL-D for Distributed Systems

CONTROL-D for Distributed Systems is a separately licensed product for report
distribution to a Unix or Windows/NT environment. If CONTROL-D for Distributed
Systems is installed at your site, you can use its features to specify an external logical
destination for CONTROL-V reports. For more information about this product, see
CONTROL-D for Distributed Systems on page 286.

CONTROL-D Application Server

The CONTROL-D Application Server provides access to CONTROL-V User Report
files by CONTROL-D/WebAccess Server users of CONTROL-D/Page On Demand.
It is activated by the IOAGATE monitor.

CONTROL-D/Page On Demand is a separately licensed add-on feature that is

available in addition to the batch download method.

CONTROL-D/Page On Demand enables CONTROL-D/WebAccess Server users to

view reports that reside on mainframe storage in real time. There is no need to
replicate and send large production reports over the network to all potential online
viewing users. At sites where CONTROL-D/Page On Demand is active, reports are
centrally stored and users retrieve only the pages they require.

For more information about CONTROL-D/Page On Demand, see the CONTROL-D

and CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

Reporting Facility
Two types of reports are available:

Reports that can be produced with the Online facility can also be generated in
batch mode using IOA KeyStroke Language (KSL). For more information about the
KeyStroke Language, refer to the KeyStroke Language (KSL) User Guide.

A paper usage report that cannot readily be produced using the Online facility or
KSL is provided by a special utility.

Chapter 1 Introduction 53
Shout Facility

Some CONTROL-V reports are produced from the information in the IOA Log file.
Other reports are produced from the Active Missions file or User Report List files.
Statistical information is gathered from the IOA Log file to produce statistical reports.

The Reporting facility can be activated at any time.

Shout Facility
When a problem or delay occurs, CONTROL-V can notify appropriate personnel
through the Shout facility, which can send messages to a variety of destinations
including the operator console, a TSO user, and the IOA Log file.

CONTROL-V can issue a Shout message if an exception occurs when a mission is

submitted or executed (for example, a mission completes much before or long after its
anticipated execution time).

Utilities
Utilities provided with CONTROL-V are used to perform a variety of management
functions and generate reports that assist in the efficient use of CONTROL-V.

For information about batch utilities, see the INCONTROL for z/OS Utilities Guide.
For information about online utilities, see Utilities Under ISPF on page 407.

Functions that can be performed by utilities include:

Adding, checking, or deleting prerequisite conditions.

Loading (building) the IOA Manual Conditions file.
Cleaning unneeded reports from User Report List files.
Formatting CONTROL-V files.
Performing operator commands.
Scheduling any type of CONTROL-V mission.

Report Decollating Mission Parameters

Report decollating mission parameters (including indexing instructions) are defined
using the Online facility. Formatted screens guide the user through the definition
process. For details about how to define these parameters online, see Report
Decollating Mission Definition Facility on page 108.

54 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Screen

Report decollating mission parameters are stored in libraries (partitioned datasets).

For each job, one member is kept containing one or more report decollating missions
for that job. A job can be decollated differently depending on when it is run. The
report decollating mission contains indexing, migration, printing and backup
instructions in addition to decollating instructions for each of the jobs reports.

Any number of libraries can be defined. For example, each group of users can have its
own library. This allows users to define report decollating mission parameters for
their jobs without any breach of security.

Although each report decollating mission is defined once, it can be updated by

authorized users at any time.

Report Decollating Mission Definition Screen

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC MONITOR
===========================================================================
DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 001 - 001 COL 014 - 046 PRINT Y REF NEXT PAGE N CONTID N AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT LINE COL -
DO USER = * LVL LINE COL 064 - 074 S A T
SYNONYM = CONCAT =
DO MIGRATE = MIG003Y
DO INDEX = EMP_NUM LINE +000 COL 001 - 006 R Y G
MASK = ###### LINE 003 - 060 COL 001 - 006 RC Y
02 SUBINDX = EMP_NAME LVL 02 LINE +000 COL 008 - 029
MASK = * LINE 003 - 060 COL 008 - 029 RC Y
02 SUBINDX = EMP_DEPT LVL 02 LINE +000 COL 031 - 034
MASK = #### LINE 003 - 060 COL 031 - 034 RC Y
SUBINDX = LVL LINE COL -
MASK = LINE - COL - RC
===========================================================================
INDEX LEVEL DISPLAY
EMP_NUM / EMP_NAME
EMP_NUM / EMP_DEPT
===========================================================================
DO BACKUP = EMPBKUP
DO PRINT = EMP_PRT COL -
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 11.58.37

Chapter 1 Introduction 55
Decollating Workflow

Decollating Workflow
A decollating mission allocates (parts of) reports to users authorized to receive them.
A decollating mission also builds one or more predefined indexes for reports so that
pages or sections of a report can be selectively retrieved for online viewing, printing,
and so on.

The workflow of a decollating mission consists of the following stages:

1. The New Day procedure analyzes the scheduling parameters of the report
decollating mission definitions and decides which decollating missions should be
executed on that day. The selected missions are placed in the Active Missions file.

2. The CONTROL-V monitor analyzes the missions runtime scheduling criteria

(prerequisite conditions, time constraints, availability of the job on the output
queue, and so on). If all scheduling criteria are met, the decollating mission
executes.

3. Generic jobs that appear on a specific output class are automatically decollated.
The generic job name can contain mask characters (for example, all jobs starting
with NDX).

4. The monitor reads reports from the spool and writes them to Compressed Dataset
Access Method (CDAM) files. Alternatively, reports can be written directly to
CDAM files without using the spool.

5. The indexing process assigns pointers to each page, section or line of a report and
identifies beginning and ending pages for each index value. For detailed
information about index design and usage, see Report Indexes on page 65.

6. Decollating parameters assign report names and specify migration, printing and
backup instructions.

7. When reports are decollated, prerequisite conditions can be added and/or deleted
(thereby triggering other events or missions in the production environment) and
messages can be sent to specified destinations via the Shout facility.

8. Decollation results are stored in the Active User Report List file.

9. After decollation, reports are available for printing, migration, online viewing, and
so on.

56 CONTROL-D and CONTROL-V User Guide

 Balancing Pages Under CONTROL-M/Analyzer

Balancing Pages Under CONTROL-M/Analyzer

At sites using CONTROL-M/Analyzer, balancing operations can be performed
automatically on CONTROL-V pages. The CONTROL-M/Analyzer Runtime
environment is invoked by inserting a DO CTBRULE statement in the report
decollating mission definition. Arguments may be passed to
CONTROL-M/Analyzer. For more information, see the discussion of
CONTROLM/Analyzer interfaces in the CONTROL-M/Analyzer User Guide.

Migration, Printing, Backup and Restore

Mission Parameters
These parameters are defined using the Online facility. Formatted screens guide the
user through the definition process. For details about how to define these parameters
online, see Migration, Printing, Backup, Restore Mission Definition Facility on
page 140.

The parameters are stored in libraries (partitioned datasets). For each mission, one
member is kept containing one or more categories of the mission.

Any number of libraries can be defined. Usually, only one library is used for each
type of mission because these missions are usually managed by one unit within the
organization.

Although the missions are defined once, they can be updated by authorized users at
any time.

Chapter 1 Introduction 57
Migration Workflow

Figure 3 Printing Mission Definition Screen

---- CONTROL-D CATEGORY DAILY PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC PRINTING MISSION FOR ALL STANDARD FORM REPORTS
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ :
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.41

Migration Workflow
A migration mission moves one or more reports from one storage device (usually
DASD) to another (usually tape, cartridge, silo or optical disk). The workflow of a
migration mission consists of the following stages:

The CONTROL-V New Day procedure analyzes the basic scheduling criteria of the
migration missions and decides which migration missions should be executed on that
day. The selected missions are placed in the Active Missions file.

The monitor analyzes the migration missions runtime scheduling criteria. If all
scheduling criteria are met, the migration mission executes.

The migration mission scans the Active User Report List file for reports that should be
migrated by the specified migration mission, but have not yet migrated. The name of
the migration mission is specified in the Report Decollating parameters.

The migration mission prepares a list of CDAM datasets and index files to be
migrated.

Control is passed to a job submitted from the CONTROL-V monitor, a job under the
CONTROL-M Production Control System, or a job submitted by another production
control system.

58 CONTROL-D and CONTROL-V User Guide

 Printing Workflow

The migration job transfers all the files in the migration list to the target media,
updates the report status in the Active User Report List file, and indicates the location
to which each CDAM file migrated.

The monitor then uses the Shout facility to add and/or delete requested prerequisite
conditions, and to notify appropriate personnel.

NOTE
After a report has migrated, all printing and viewing requests continue using the DASD copy
until it is deleted by utility CTDDELRP.

Figure 4 Migration Workflow

Printing Workflow
A printing mission is actually a bundle. It can contain reports for one or many users.
The workflow of a printing mission consists of the following stages:

The CONTROL-V New Day procedure analyzes the basic scheduling criteria of the
printing missions and decides which printing missions should be executed on the
given day. A different printing or report delivery plan can be structured for every
day regular working day, end of the month, weekend, and so on. The missions
are placed in the Active Missions file.

The monitor analyzes the missions runtime scheduling criteria (prerequisite

conditions, time constraints, priority, and so on). If all scheduling criteria are met,
the printing mission starts executing.

Chapter 1 Introduction 59
Printing Workflow

CONTROL-V initiates a printing mission only if a printer is available to the

CONTROL-V monitor. The printing mission parameters contain the list of printers
on which the bundle can be printed (for example, it is impossible to print a carbon
paper report on a laser printer). CONTROL-V selects one of the available printers.
The printer is selected taking into account the printing priorities and speed of each
printer. CONTROL-V performs workload balancing between the printers to select
the fastest printing order to achieve printing priorities.

After a printer has been selected for the printing mission, a printing plan is
prepared:

The printing parameters specify the users who should receive the reports. The
Active User Report List file is scanned for all scheduled by as yet unprinted
reports of the selected user (and that users descendants in the Recipient Tree).
The copy count and printing destination are taken from the user records in the
Active User Report List file.

The specific pages of reports to be printed are sorted according to the specified
printing mission sort parameters.

The printing plan is saved on a file (to allow for recovery and checkpointing) and
can be viewed and controlled online.

Control is passed to the Printers Control monitor to execute the printing plan. The
Printers Control monitor sends to the spool a calculated amount of lines (for
example, 10,000 at a time). The monitor periodically checks the status of the
printing lines. When the printer is about to finish printing the lines, additional
lines are placed on the spool. With this method, the spool contains the minimum
number of lines required to keep the printer busy.

If new printing characteristics need to be used, the Printers Control monitor

closes the currently printing chunk of lines and opens a new one with the new
characteristics. Therefore, it is possible to mix different printing characteristics
in the same bundle.

If the user has specified a special printing ruler for a report, the report is edited
accordingly.

The Printers Control monitor passes control to various exits which can change the
printed lines, edit banner pages, print the bundle report index, and so on. Sample
exits are supplied in the IOA SAMPEXIT library.

When printing in LINE MODE or PAGE MODE on IBM AFP laser printers, special
parameters and special CONTROL-V supplied user exits are invoked to support
the IBM PSF. These exits can be tailored for local use.

When printing on a Xerox 8700/9700 printer, special CONTROL-V supplied user

exits are invoked to support DJDE parameters.

60 CONTROL-D and CONTROL-V User Guide

 Backup Workflow

The printing process can create System Management Facility (SMF) records which
allow billing and charge back at the job level or at the report recipient level.

When printing is finished, control is passed to the CONTROL-V monitor. The

monitor then adds and/or deletes requested prerequisite conditions and uses the
Shout facility to notify appropriate personnel.

A printing mission can be scheduled and processed as a batch job, similar to a backup
mission or restore mission. Batch printing jobs are executed via skeleton JCL kept as a
library member. Batch printing can utilize or ignore the regular chunking mechanism.
A time-out mechanism can be used to terminate the printing mission if it does not
begin on time.

Backup Workflow
A backup mission backs up a group of reports for a specified number of days or
generations. The workflow of a backup mission consists of the following stages:

The CONTROL-V New Day procedure analyzes the basic scheduling criteria of the
backup missions and decides which missions should be executed on the given day
(for example, different backup procedures can be employed for end-of-month
processing versus the regular working day). The missions are placed in the Active
Missions file.

The monitor analyzes the missions runtime scheduling criteria (prerequisite

conditions, time constraints, priority, and so on). If all scheduling criteria are met,
the backup mission executes.

The backup mission scans the Active User Report List file for reports which should
be backed up by the specified backup mission and have not been backed up yet.
The name of the backup mission is specified in the report decollating parameters.

The backup mission prepares a list of datasets to be backed up. The list can be in
one of the following formats:

DF/DSS
DF/HSM
FDR
DMS/OS
ASM2
ARCS
Site controlled format

Chapter 1 Introduction 61
Restore Workflow

Control is passed to either:

A job under the CONTROL-M Production Control System

A job submitted by another production control system
A job submitted from the CONTROL-V monitor

The job backs up all the files in the list in a fast and reliable manner since it
employs the standard backup procedures used by the site.

After the job finishes executing, it notifies the CONTROL-V monitor that the
backup has successfully completed, and lists the tape numbers used in the backup
process.

Optionally, the monitor adds and/or deletes requested prerequisite conditions and
uses the Shout facility to notify appropriate personnel.

Restore Workflow
A restore mission restores reports from tape or cartridge back to disk. The workflow
of the restore mission consists of the following stages:

The CONTROL-V New Day procedure analyzes the basic scheduling criteria of the
restore missions and decides which restore missions should be executed on the
given day (for example, different restore procedures can be employed for
end-of-month processing versus the regular working day). The missions are placed
in the Active Missions file.

The user can request a restore by selecting option R on the History User Report list
screen. The user is prompted with a list of possible restore missions. After selecting
the desired restore mission, the restore request is recorded in the input queue of
the specified restore mission. In addition, a prerequisite condition is (usually)
added to the IOA Conditions file. Each restore mission has at least one prerequisite
condition that indicates to the restore mission that a restore is needed.

The monitor analyzes the missions runtime scheduling criteria (prerequisite

conditions, time constraints, priority, and so on). If all scheduling criteria are met,
the restore mission executes. Restore missions are usually triggered by the
associated prerequisite condition together with a time interval (for example, two
hours between each restore mission).

The restore mission prepares restore parameters for all files in its queue (that is, for
all restore requests that have accumulated since the last executed restore).

62 CONTROL-D and CONTROL-V User Guide

 Restore Workflow

The restore mission prepares a list of datasets to be restored (and their tape
numbers). The list can be in one of the following formats:

DF/DSS
DF/HSM
FDR

Site controlled format

DMS/OS
ASM2
ARCS

Control is passed to either:

A job under the CONTROL-M Production Control System

A job submitted by another production control system
A job submitted from the CONTROL-V monitor

The job restores all the files in the list in a fast and reliable manner since it employs
the standard restore procedures used by the site.

The restored User Report entries are copied from the History User Report List file
to the Active User Report List file, making them available for online viewing.

After the job finishes, it notifies the CONTROL-V monitor that the restore has been
successfully completed, and lists the tape numbers used in the restore process.

Optionally, the monitor adds and/or deletes requested prerequisite conditions and
uses the Shout facility to notify appropriate personnel.

Chapter 1 Introduction 63
Online Viewing

Online Viewing
The User Reports entry panel enables end users (that is, report recipients) and
operations personnel to access CONTROL-V report information. Users can retrieve a
list of user reports based on the following selection criteria:

Report name.
Main index name and value.
User name.
Date and time ranges.
Migration status of the report.
Report status.
Job name, prefix or mask.
Site-defined category or mask.
Condition code or user-specified remark.
Only reports that the user is authorized to see are included in the list.

Many operations can be made on the list. The most significant of these operations is
the online viewing function that enables the user to select report pages by hierarchical
index values and view these pages online. Hard copy can always be requested by the
online viewer at any time.

For more information, see Report Indexes on page 65 and Using Indexes for
Report Retrieval on page 180.

Figure 5 Online Viewing Operations

64 CONTROL-D and CONTROL-V User Guide

 Report Indexes

Report Indexes
Indexes are defined using the DO INDEX statement in the Report Decollating
Mission Definition screen (option R in the IOA Primary Option menu).

An index definition is in one of the following formats:

LINE
VAR

A LINE format index definition consists of the following:

a specified line

a column specification, which must be one of the following:

a specified column range

a column relative to the column identified by the mandatory MASK value

an index type

A VAR format index definition consists of the following:

a specified variable
an index type

There are three index types

Page Level Every page of the report can be indexed by one value. Page Level is
mandatory in a VAR format index definition.

Record Level Every line of every page in the report can be indexed by one value.

Continuous Record Level Identical to record level except records without an

index value are indexed by the last previous value found for this index.

During the report decollation process, values for each index are extracted as a text
string, either from the lines on the report page or from a specified variable. These
index values enable users to determine if desired information is available, and to
retrieve only the desired information for online viewing or printing.

Chapter 1 Introduction 65
Index Hierarchies

Index Hierarchies
Main indexes and a hierarchy (tree structure) of subindexes can be defined for each
report. Each unique sequence of indexes in a hierarchy constitutes an index path. An
index path can have both page level and record level indexes. For more information
about index specification, see DO INDEX: Decollating Parameter on page 462.

Index Values and Masks

An optional index mask can be defined for each page level index and subindex. An
index mask must be defined for each record level index and subindex. If a relative
column is specified, an index mask must be defined for each index and subindex.

If the index value for a report is not all contained in one range, or is not contained in
the report at all, use a variable in defining the index.

When pages in a report have more than one format, a specified line or column range
may contain values for a particular index on some report pages, but may not contain
index values (or may contain values for a different index) on other report pages.
Therefore, when defining indexes for reports with multiple page formats, it is
necessary to ensure that the text strings in a specified line or column range are in fact
appropriate index values. This can be done by defining an index mask.

An index mask definition specifies a mask value and a column range in a line range.
If the content of the mask line or column range in the report matches the specified
mask value, the content of the index line or column range of the report is validated as
a genuine index value. The line or column ranges for the index value and its mask
value may be identical, may overlap, or may have no overlap.

Example

A report contains pages in either of two formats: Branch Summary format or Account
Summary format.

In the Branch Summary format:

Line 2, columns 18 22 contain bank branch numbers. This line and column
combination is used to define index 1_BRANCH_NUM.

Line 1, columns 47 60 contain the value BRANCH SUMMARY. This value

does not appear in same location in other formats. It is used to define a mask for
index 1_BRANCH_NUM.

66 CONTROL-D and CONTROL-V User Guide

 Multi-value indexes

In the Account Summary format:

Line 2, columns 17 25 contain account numbers. This line and column

combination is used to define index 2_ACCT-NUM.

Line 2, columns 2 15 contain the value ACCOUNT NUMBER. This value does
not appear in the same location in other formats. It is used to define a mask for
index 2_ACCT_NUM.

Because the line and column ranges for branch numbers and account numbers are
almost identical, using masks ensures that only branch numbers are extracted for
index 1_BRANCH-NUM and only account numbers are extracted for index
2_ACCT-NUM.

Usage of mask definitions is not limited to reports in which pages have various
formats. Mask definitions can be useful in other situations. For example, each page
may have the same format, but the report page may only be of interest when the
contents of a specified location matches a mask. In this case, extraction of index
values can be limited to those situations in which the mask criteria are satisfied.

Multi-value indexes
You can define a multi-value index that contains multiple values for more than one
index value in an index within

the same page in a page level index

the same line in a record level index

It is possible to access the indexed page or line or a report using any multi-value.
There are three ways to create a multi value index:

from a range according to a mask.

from the multiple value ranges
with separate subindex values

For more information, refer to Multi-value indexes on page 471.

Indexes, Reports and CDAM Files

Index values for each index are extracted from the report by the decollating mission.

Chapter 1 Introduction 67
Index Design

Each index value points to all report pages that contain that index value in the
defined index location. Each logical report page or section is pointed to by only one
value in a given index. Any page without an value that can be indexed is treated as a
continuation of the previous pages in that report section. For this reason, a request to
view a report based on index values may retrieve one or more consecutive or
nonconsecutive report pages.

Each index value points to relevant report pages or sections in a single CDAM file.
Therefore, WHEN statements that contain DO INDEX statements should select report
pages that are in the extents of a single CDAM file. For information about WHEN
statements, see WHEN Statements on page 428. For information about CDAM files,
see Chapter 5, Compressed Dataset Access Method (CDAM).

Index Design
Well designed indexes can enable users to retrieve important information without
viewing the report itself. For example, if a bond portfolio report with one bond per
page contains a redemption date field, indexing that field produces a sorted list of all
bond redemption dates which can be displayed in the Values of Index panel, without
retrieving the report.

Page Level Indexes

Page level indexing should be used whenever a report page can be adequately
indexed by one value per index per report page. The bond portfolio report described
above may have separate indexes for bond name, redemption date, and the
responsible securities analyst. Page level indexing is appropriate for each of these
indexes.

Record Level Indexes

By contrast, an inventory report sorted by part number may have 20 to 30 different
part records listed on each report page. Indexes for part name and part number
require multiple values per report page. Record level indexing is appropriate for each
of these indexes.

Continuous Record Level Indexes

Another version of the same inventory report may be sorted by a storage area
identifier which (later) occurs only in a single record that precedes the records of all
parts that are stored in that area. Continuous record level indexing is appropriate for
the storage area index so that the applicable storage area value points to the records
of the parts that are stored in that area.

68 CONTROL-D and CONTROL-V User Guide

 Index Migration

Index Paths
CONTROL-V enables users to retrieve parts of reports based on any predefined index
path. Separate index paths should be defined for each meaningful way to retrieve a
report page or section. For example, an accounts receivable report may have the
following paths:

1_acct_number, 1_acct_name, 1_acct_executive, 1_balance_due,

1_past_due_amount

2_sales_region, 2_acct_executive, 2_acct_num, 2_balance_due,

2_past_due_amount

3_sales_region, 3_past_due_amount, 3_acct_num, 3_acct_name, 3_acct_executive

It is recommended that every index be given a unique name. For more information
about report and index design, see Report Design on page 820 and Index Design
on page 821.

Index Migration
A maximum of three main indexes per report can remain in DASD when a report
migrates. A main index and its subindexes remain DASD resident or migrate as a
unit. For more information about report and index migration, see the CONTROL-D
and CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

Index Size
Index size is a function of index field width, the number of different index values that
occur in the report, and how the report is sorted. Sorting affects index size because
each index entry contains a separate pair of pointers to the beginning and ending
pages of each nonconsecutive occurrence of the index value in the report.

Chapter 1 Introduction 69
Using Indexes for Retrieval

Using Indexes for Retrieval

Report pages can be retrieved for viewing or immediate printing regardless of where
the report is stored. When index values are included in report selection criteria, only
those pages or sections of the report that are pointed to by the specified index values
are retrieved.

Online screens in the User Reports facility enable the user to:
Identify the report from which pages should be retrieved.
Identify the indexes whose values should be specified as selection criteria.
Specify a value for the selected indexes.
Specify viewing or immediate printing for the selected report pages.

Retrieval Methods
There are two basic methods of specifying index values for report retrieval:

Table 2 Index Value Specification Methods

Method Description
Quick Access Method This method utilizes Quick Access panels to display
each index path. Values can be assigned to the indexes
in a path.
Index/Subindex Window Method This method utilizes windows to display the available
indexes at a hierarchy level. An index can be selected
and its value specified.

In both methods, available index values are displayed alphabetically in a Values of

Index panel. Values in the panel can be specified for use in retrieval.

For detailed information about these methods, see Using Indexes for Report
Retrieval on page 180.

Prerequisite Condition Concept

The prerequisite condition concept is one of the fundamentals of the INCONTROL
production environment. A prerequisite condition is a user-defined descriptive name
given to a situation, event, or condition.

70 CONTROL-D and CONTROL-V User Guide

 Prerequisite Condition Concept

Prerequisite conditions are either created by previous jobs, created by CONTROL-V

missions, or created manually via the Online facility. A jobs reports is decollated or
migrated only when all prerequisite conditions defined as necessary for the execution
of the mission exist.

The following are examples of prerequisite conditions:

Table 3 Prerequisite Condition Examples

IMS-ACTIVE an ongoing situation
BALANCE-CHECKED completion of a manual operation
INVENTORY-REPORT-DECOLLATED an event
MIGRATION-ALLOWED an ongoing situation
INVENTORY-DATA-SET-CREATED creation of a dataset

A list of prerequisite conditions can be specified in the mission definition parameters.

CONTROL-V allows mission execution only if all the prerequisite conditions exist.
For example, a printing mission executes only when all prerequisite decollating jobs
have run successfully.

Figure 6 Decollating Jobs Prerequisite Conditions Example

Prerequisite conditions can be used to create any kind of dependency (for example,
mission to mission, mission to job, manual operations, creation of a dataset).

Prerequisite conditions can be added or deleted in many ways:

By using the Online facility

By specifications in the missions definition parameters
By an application program or a job step using a supplied routine or utility
By the CONTROL-M Production Control System

The Online facility is used to add conditions like AR-BALANCED. These prerequisite
conditions represent manual operations. They can be added by any authorized user.

Chapter 1 Introduction 71
IOA Calendar Facility

The most common way of adding or deleting a condition is by defining it in the

mission definition parameters. A list of prerequisite conditions to be added or deleted
when the mission finishes OK can be specified by the user. For example, it can be a
simple condition like EJ18FOR-DECOLLATED, or it can represent a more complex
situation like SALARY-FINISHED.

Prerequisite conditions can also be used as a trigger for messages; for example, the
user can tell CONTROL-V to send a highlighted, unrollable message to the operator
console whenever the condition CHECK-NOT-BALANCED exists.

Prerequisite conditions are strictly under the users control. Any number of
conditions, and therefore any number of dependencies, can be created. Prerequisite
conditions can be used for any purpose.

IOA Calendar Facility

Specification of scheduling criteria for missions can be simplified by using calendars.
A calendar is a defined schedule (for example, every day except Saturdays and
Sundays of each month) that can be applied to missions.

Calendars are defined in the IOA Calendar facility. Each calendar is given a unique
name that can be specified in mission definitions. A particular calendar (that is, a
unique set of dates) only needs to be defined once.

Specifying a calendars name in a mission definition enables that mission to be

scheduled on the dates specified in that calendar.

Two types of calendars can be defined: regular and periodic.

Regular calendars consist of scheduling dates or days (of the week) that can be
defined according to monthly patterns.

Example 1

Table 4 Regular Calendar Example

Parameter Description
WEEKDAYS Schedules missions on every weekday (Monday through Friday) in each
month.
WEEKENDS Schedules missions on every Saturday and Sunday each month.
QUARTERLY Schedules missions on the last date in each quarter: March 31,
June 30, September 30, December 31.

72 CONTROL-D and CONTROL-V User Guide

 Date Definition Concepts

Regular calendars are especially useful when many missions have the same schedule.
Defining that schedule once in a calendar, and specifying that calendars name in the
mission definition of those missions, makes it unnecessary to individually define that
schedule in the mission definition of those missions.

Periodic calendars are especially useful when scheduling dates do not conform to
fixed date/day of the week/month patterns.

Example 2

PAYCAL Schedules missions (for example, payroll) every other Wednesday.

Scheduling occurs on the first, third, and (if there is one) fifth Wednesday of some
months. Scheduling occurs on the second and fourth Wednesday of other months.

The IOA Calendar facility is described in IOA Calendar Facility on page 390.

Date Definition Concepts

IOA uses the following types of date definitions:

System date
Working date
Original scheduling date

System Date
This date is supplied by the operating system. It should be the actual calendar date
starting and ending at midnight.

Working Date
Many sites do not use midnight as the formal time for changing to a new date. A site,
for example, may decide that transactions between 13:00 and 24:00 belong to the next
days transactions. In this case, the working date changes at 13:00 and not at
midnight.

The working date (that is, the time at which a date changes at the site) is defined in
the CONTROL-D installation parameters. New Day processing generally begins at
the start of the new working date.

Chapter 1 Introduction 73
Original Scheduling Date

Original Scheduling Date

The original scheduling date (ODATE) is the working date that CONTROL-V assigns
to a mission, a message or a condition.

Every item under CONTROL-V is assigned an original scheduling date. For

missions, it is the date on which the mission should be scheduled for execution. For
messages, it is the original scheduling date of the mission that generated the message.

The importance of the ODATE can be illustrated by the following example:

The computer is down for two days. When it is brought up on the third day, there is a
two day backlog of jobs to be run, in addition to the jobs of the current day. It is
desired that the jobs in the backlog have a run date matching their intended (original)
scheduling date, not the working date when the computer was brought up. This is
achieved by specifying the ODATE as the run date. The jobs are then executed as if
they had run on their originally scheduled working dates.

Date Standards and Date Field Formats

Date standards and date field formats use either Gregorian or Julian dates.

Gregorian Dates
Gregorian dates are indicated in the guide by the following symbols:

Table 5 Gregorian Date Formats

Symbol Description
dd Day of the month (01 31)
mm Month (01 12)
yy Last two digits of the yeara
yyyy Four digits of the year
a If the last two digits in the specified year are a number less than 56, IOA presumes that the
year is in the 21st century (for example, if yy is 15, the year 2015 would be presumed).
Otherwise, IOA presumes that the year is in the 20th century (for example, if yy is 80, the year
1980 would be presumed).

Whether a field holds a 4-character date (month and day), a 6-character date (month,
day and 2-digit year) or an 8-character date (month, day and 4-digit year) depends on
the field. However, the format of the 4-character, 6-character or 8-character date
depends on the installation defined date standard.

74 CONTROL-D and CONTROL-V User Guide

 Date Standards and Date Field Formats

INCONTROL products support three date standards for Gregorian dates. Each
standard has an 8-character format, a 6-character format and a 4-character format.
Only one Gregorian date standard is defined at any site.

These supported Gregorian date standards are described in the chart below.

Table 6 Gregorian Date Standards

Standard 4-Character Date 6-Character Date 8-Character Date
MDY mmdd mmddyy mmddyyyy
DMY ddmm ddmmyy ddmmyyyy
YMD mmdd yymmdd yyyymmdd

Julian Dates
Julian dates are indicated in the guide by the following symbols:

Table 7 Julian Date Formats

Symbol Description
jjj or ddd Day of the year (001 365 or 366, as appropriate for the year)
yy Last two digits of the year
yyyy Four digits of the year

Julian date fields have either three, five, or seven characters. Whether a Julian date
field holds a 3-character date (day of year only), 5-character date (day of year and
2-digit year) or a 7-character date (day of year and 4-digit year) depends on the field
definition. However, the format of the date depends on the installation defined date
standard.

For example, the Julian date for the calendar date of 28 February 2000 would be
represented in jjj or ddd format as 059, in yyjjj or yyddd format as 00059, and in
yyyyjjj or yyyyddd format as 2000059.

Chapter 1 Introduction 75
Date Standards and Date Field Formats

76 CONTROL-D and CONTROL-V User Guide

 Chapter

2
2 Online Facilities
This chapter contains the following topics:

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
IOA Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
General IOA Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
IOA Entry Panel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
IOA Primary Option Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Multi-Screen Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Fast Exit From the IOA Online Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Screen Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Commands and PFKeys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
IOA Under ISPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
IOA Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
IOA SET Command Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
IOA TSO Command Processor Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Report Decollating Mission Definition Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
Accessing the Report Decollating Mission Definition Facility . . . . . . . . . . . . . . . 109
Creating Members . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
Creating Mission Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Performing Operations on Members and Mission Definitions . . . . . . . . . . . . . . 110
Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
Report Decollating Mission Definition Job List . . . . . . . . . . . . . . . . . . . . . . . . . . 115
Report Decollating Mission Definition Category List. . . . . . . . . . . . . . . . . . . . . 117
Report Decollating Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
Editing Mission Definitions in the Edit Environment . . . . . . . . . . . . . . . . . . . . . . 133
Exiting the Report Decollating Mission Definition Screen . . . . . . . . . . . . . . . . . . 134
Ordering Report Decollating Missions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
Copying Report Decollating Mission Definitions to Another Member . . . . . . . 138
Migration, Printing, Backup, Restore Mission Definition Facility . . . . . . . . . . . . . . . 140
Accessing the Migration, Printing, Backup, Restore Mission Definition Facility . .
140
Creating Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Creating Mission Definitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
Performing Operations on Missions and Mission Definitions . . . . . . . . . . . . . . . 141
Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143

Chapter 2 Online Facilities 77

 Migration, Printing, Backup, Restore Mission Definition Mission List Screen 147
Migration, Printing, Backup, Restore Mission Definition Category List Screen . .
149
Migration, Printing, Backup, Restore Mission Definition Screen . . . . . . . . . . . . . 152
Editing Mission Definitions in the Edit Environment . . . . . . . . . . . . . . . . . . . . . . 165
Exiting the Mission Definition Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
Ordering Missions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
Copying Migration, Printing, Backup, Restore Mission Definitions to Another
Member . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169
Recipient Tree Definition. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
Recipient Tree List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
Recipient Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
Exiting a Recipient Tree List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 178
User Reports (Online Viewing) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 179
Using Indexes for Report Retrieval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
Report Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
Quick Access Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Values of Index Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
Index Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
Subindex Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
GIVETO Option Distributing Reports to Other Users. . . . . . . . . . . . . . . . . . . . . 236
Printing Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 238
Restoring Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
Notepad Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241
Report Viewing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246
Editing (Reformatting) Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Tag Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
Using the Report Viewing Screen To View AFPDS Reports On 3270 Monitors. 278
$SYSDATA Records. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
CONTROL-D for Distributed Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
Specifying an External Destination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
CONTROL-D External Destinations Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
File Transfer Control for Sites With CONTROL-D/PC . . . . . . . . . . . . . . . . . . . . . . . . 294
CONTROL-D/PC Workflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 296
Fields of the File Transfer Control Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Transfer Statuses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
Options of the File Transfer Control Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
Transfer of Index Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 298
SHOW Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
Report Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
Packet Zoom Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
Packet Index Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
Tracking and Control Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
Format Commands of the Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . 306
Fields of the Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 306
Specifying Retrieval Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
Options of the Active Missions Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

78 CONTROL-D and CONTROL-V User Guide

 Why Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 312
Mission Log Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
Zoom Screens . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 316
Rerun Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
Print Control Print Plan Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
CONTROL-D Objects Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Accessing the CONTROL-D Objects Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
Report Cliques . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
Resource Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 354
Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 358
Clique Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 360
Approval and Subscribe Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
Condition and Resource Handling Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
IOA Conditions/Resources Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
IOA Manual Conditions Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 374
IOA Log Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
IOA Log Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 379
IOA Calendar Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 390
Accessing the IOA Calendar Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 391
Entry Panel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
Calendar List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
Year List Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
Copying Years to Another Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 398
Calendar Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
Exiting the IOA Calendar Facility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 404
Utilities Under ISPF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
IOA Online Utilities Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 407
D1: Schedule a Report Decollating Mission. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
D2: Schedule a Printing Mission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410
D3: Schedule a Backup / Migration Mission . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
D4: Schedule a Restore Mission. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 413
I1: Add, Check, or Delete a Prerequisite Condition . . . . . . . . . . . . . . . . . . . . . . . . 415

Chapter 2 Online Facilities 79

Overview

Overview
The Online facility is the basic means of communication between the user and
CONTROL-V.

Online mission definition gives users the ability to define and modify parameters for
report decollating, printing, backup and restore missions in the CONTROL-V
environment.

Online tracking displays the current status of all variables relating to a specific
mission, a group of missions or all the missions scheduled under CONTROL-V.

Online control enables authorized users to modify variables relating to a specific

mission, a group of missions or all the missions scheduled under CONTROL-V.

This chapter describes the main features of the Online facility.

IOA Features
This section discusses the IOA features common to all INCONTROL products.

General IOA Features

General IOA features include:

Customization
Environment Support
Terminal Support
Special Character Usage on Terminals
Color Support
Prefixing
Character Masking

Customization
IOA screens, constants, messages, colors, commands and PFKey definitions can be
site-modified to adapt them to local needs. For more information, see the
INCONTROL for z/OS Installation Guide for details.

80 CONTROL-D and CONTROL-V User Guide

 General IOA Features

INCONTROL products can be customized globally (for the whole site) using the
INCONTROL Installation and Customization Engine (ICE) according to profile
variables defined during installation.

In addition, INCONTROL products can be customized to respond differently to

individual users if these profile variables are specified in User profile members.

For example, depending on the setting of a variable in a particular User profile

member, upon exit from a screen in which changes have been requested, this
INCONTROL product may either perform the requested changes automatically or
display a confirmation window before performing the changes.

Customization issues are discussed in the IOA administration chapter of the

INCONTROL for z/OS Administrator Guide.

NOTE
Due to customization, screens and examples illustrated in this guide may differ from the ones
used at your site.

Environment Support
The Online facility can be activated under the following environments:

TSO (native)
TSO/ISPF
ROSCOE/ETSO
CICS
VTAM
IMS/DC
IDMS/DC
COM-PLETE

Cross memory interfaces to the Online monitor are optional under native TSO,
TSO/ISPF, and ROSCOE/ETSO. They are always used under the other
environments.

There are slight differences in the operation of the Online facility under the different
environments. Special notes are provided in the guide where applicable.

Chapter 2 Online Facilities 81

General IOA Features

Terminal Support
IOA supports the following models of the IBM 3270 terminals:

Model 2 24 lines, 80 columns

Model 3 32 lines, 80 columns
Model 4 43 lines, 80 columns
Model 5 27 lines, 132 columns

NOTE
When using the IOA online facility under IMS/DC and IDMS/DC, all model types display 24
lines and 80 columns.

IOA adjusts to the screen size in order to use the maximum available data area on the
screen.

Special Character Usage on Terminals

In certain cases, special keyboard characters, such as $, # , and @, are assigned special
meanings. The characters specified appear on standard American terminals but may
not be available on other keyboards. In addition, some special characters on your
keyboard may be assigned different hexadecimal values than the ones recognized by
IOA. Special keyboard mapping requirements, and a complete discussion of the
conventions used in this guide, are shown in Conventions Used in This Guide on
page 34.

Color Support
When INCONTROL products are activated from a screen with extended seven color
support, they make extensive use of the color attributes of the screen. The concept of
management by color is emphasized in INCONTROL screens.

Like all screen attributes, the color attribute for each field is defined externally to the
program and can be locally modified by the site.

82 CONTROL-D and CONTROL-V User Guide

 General IOA Features

NOTE
IOA does not automatically recognize IMS/DC and IDMS/DC terminals as supporting
extended color attributes. If your IMS/DC or IDMS/DC terminal supports extended color
attributes and you want IOA to recognize this, refer to the IOA administration chapter of the
INCONTROL for z/OS Administrator Guide for more information.

At this time, IOA does not support extended color attributes under COM-PLETE.

Due to ISPF characteristics, color changes cannot occur in adjacent columns but must be
separated by an attribute byte without color, that is, black. Therefore, some IOA screens have
a different appearance under ISPF than under other online environments, such as native TSO
and CICS.

Prefixing
For fields that automatically support prefixing, selection strings are always treated as
prefixes. Selection is made if a segment of the text beginning with the first letter (that
is, any prefix) matches the selection criteria.

Examples

Assume the following names exist: A3, A4, M, M01, M03, M12, M13, M22, M23, M30,
M33, M103, M135, M301.

Table 8 Prefixing Examples

Entry Matching values
blank All the above values
A A3, A4
M M, M01, M03, M12, M13, M22, M23, M30, M33, M103, M135, M301
M1 M12, M13, M103, M135
M13 M13, M135

If a field supports prefixing, this is indicated in its description.

Character Masking
For fields that support masking, mask characters function as follows:

* represents any number of characters (including no characters).

? represents any one character.

For fields that do not automatically support prefixing, a prefix value can be specified
by ending the selection with an asterisk (*).

Chapter 2 Online Facilities 83

IOA Entry Panel

Examples

Assume the following names exist: A3, M, M3, M01, M03, M13, M23, M33, M103,
M435, M2243.

Table 9 Masking Examples

Entry Matching Values
* All the above values
M?3 M03, M13, M23, M33
M??3 M103
M*3 M3, M03, M13, M23, M33, M103, M2243
M* M, M3, M01, M03, M13, M23, M33, M103, M435, M2243 (since the last character
in this example is *, M is treated as a prefix)
M?3* M03, M13, M23, M33, M435

If a field supports masking, this fact is indicated in its description.

IOA Entry Panel

Enter the IOA online facility according to the instructions of your INCONTROL
administrator. Upon entering the IOA online facility, the IOA entry panel may be
displayed.

NOTE
Display of the IOA Entry Panel is optional. If your INCONTROL administrator determined
that the entry panel is bypassed, the IOA Primary Option menu, which is discussed in the
following section, is displayed.

84 CONTROL-D and CONTROL-V User Guide

 IOA Primary Option Menu

Figure 7 IOA Editor Edit Entry Panel

----------------------------- IOA ENTRY PANEL -----------------------------

+-----------------------------------------------------------+
| |
| USER ID ===> |
| |
| PASSWORD ===> |
| |
| NEW PASSWORD ===> ===> |
| |
+-----------------------------------------------------------+

PLEASE FILL IN USER ID AND PASSWORD AND PRESS ENTER 18.30.18

Type your user ID and password and press Enter. If you enter a correct user ID and
password, the IOA Primary Option menu is displayed.

The IOA Online facility allows three attempts to enter a valid user ID and password
combination. After the third unsuccessful attempt, the program is terminated.

To change a password, type the new password twice: Once in the NEW PASSWORD
field and once in the confirmation field to the right of the NEW PASSWORD field.

IOA Primary Option Menu

The IOA Primary Option menu is the primary interface to functions available under
the various INCONTROL products. The options displayed in the menu depend on
the INCONTROL products installed at the site, and the functions and facilities that
have been authorized to you.

If only CONTROL-D and CONTROL-V are installed at your site, and you are
authorized to access all functions and facilities, the following screen is displayed:

NOTE
When the Online facility is activated as an ISPF application, options 6 is displayed as: 6
UTILITIES Online Utilities. In this case, option 6 activates the Online Utilities under ISPF.
When the Online facility is not activated under TSO or TSO/ISPF, option 6 is inactive.

Chapter 2 Online Facilities 85

IOA Primary Option Menu

Figure 8 IOA Primary Option Menu when only CONTROL-V is Installed

--------------------- IOA PRIMARY OPTION MENU -----------------(1)
OPTION ===> USER N22A
DATE 19.08.01

4 COND-RES IOA Conditions/Resources Display

5 LOG IOA Log Display
6 TSO Enter TSO Command
7 MANUAL COND IOA Manual Conditions Display
8 CALENDAR DEF IOA Calendar Definition
IV VARIABLE DATABASE IOA Variable Database Definition Facility
C CMEM DEFINITION CTM Event Manager Rule Definition
A MISSION STATUS CTD/V Active Mission Status Displ
M MISSION DEF CTD/V Prt/Bkp/Rst/Mig Mission Def
R REPORT DEF CTD/V Rep Decol/Index Mission Def
T RECIPIENT TREE CTD Recipient Tree Definition
U USER REPORTS CTD/V Reports-Status/Update/View
F PC PACKET STATUS CTD File Transfer to CTD/WebAccess Server
DO OBJECTS CTD Objects

COMMANDS: X - EXIT, HELP, INFO OR CHOOSE A MENU OPTION 18.12.41

To select an option, type the option number or letters in the OPTION field and press
Enter. Alternatively, for a number option, press the PFKey with the same number.
For example, to select the LOG option, press PF05.

NOTE
Your INCONTROL administrator can limit the options displayed on a user-by-user basis, and
can alter option numbers and customize option descriptions. Product-supplied default
options are discussed in this guide.

Certain IOA commands, functions, and facilities (options) are shared by all
INCONTROL products. These shared IOA commands, functions and facilities are
described later in this chapter, and outlined in Table 10.

Table 10 INCONTROL Shared IOA Functions and Facilities (part 1 of 2)

Option Function Description
4 COND/RES Display and update status of the IOA Conditions file
and CONTROL-M Resources file.
5 LOG View audit trail information about jobs, missions and
rules scheduled under the supervision of IOA
products.
6 TSOa Perform TSO commands.
7 MANUAL COND Display the list of prerequisite conditions that should
be confirmed manually by operations personnel.
8 CALENDAR DEF Define scheduling calendars.

86 CONTROL-D and CONTROL-V User Guide

 IOA Primary Option Menu

Table 10 INCONTROL Shared IOA Functions and Facilities (part 2 of 2)

Option Function Description
X EXIT Exit the Online facility.
INFO INFO Display a window in the IOA Primary Option Menu.
The window contains information about installed
INCONTROL products. For more details on the
information displayed by this command, refer to
IOA Version Information on page 89.
a
When the Online facility is activated as an ISPF application, option 6 is displayed as:
6 UTILITIES Online Utilities. In this case, option 6 activates the Online utilities under ISPF.
When the Online facility is not activated under TSO or TSO/ISPF, option 6 is inactive.

NOTE
Entering =1 in the command line of any other screen returns you to the IOA Primary Option
Menu that is displayed at your site.

The following commands, functions, and facilities (options) are applicable to

CONTROL-D:

Table 11 CONTROL-V Functions and Facilities

Option Function Description
A MISSION STATUS Display and update Active Missions
status.
M MISSION DEF Define printing, backup and restore
missions.
R REPORT DEF Define decollating missions.
T RECIPIENT TREE Display and update the Recipient Tree.
U USER REPORTS Display the status of user reports. View
report pages online.
F PC PACKET STATUS Display the status of reports (packets) that
have been scheduled for transfer from the
mainframe to a PC.

The following IOA Primary Option menu is displayed at sites supporting all
currently available INCONTROL products (under ISPF)

NOTE
Option OK (KOA Recorder facility) is available only under IOATSO, and not under IOAISPF
or IOAMON.

Chapter 2 Online Facilities 87

IOA Primary Option Menu

When the IOA online facility is activated as an ISPF application, option 6 is

displayed as 6 UTILITIES Online Utilities. In this case, option 6 activates the
Online utilities under ISPF. When the online facility is not activated under TSO
or TSO/ISPF, option 6 is inactive.

Figure 9 IOA Primary Option Menu when all INCONTROL Products

are Installed
--------------------- IOA PRIMARY OPTION MENU ------------------(1)
OPTION ===> USER N06

IOA CONTROL-D/V CONTROL-O

4 COND-RES A MISSION STATUS OR RULE DEFINITION

5 LOG M MISSION DEF OM MSG STATISTICS
6 TSO R REPORT DEF OS RULE STATUS
7 MANUAL COND T RECIPIENT TREE OL AUTOMATION LOG
8 CALENDAR DEF U USER REPORTS OA AUTOMATION OPTS
IV VARIABLE DATABASE F PC PACKET STATUS OC COSMOS STATUS
DO OBJECTS OK KOA RECORDER

CONTROL-M & CTM/Restart CONTROL-M/Analyzer CONTROL-M/Tape

2 JOB SCHEDULE DEF BB BALANCING STATUS TR RULE DEFINITION

3 ACTIVE ENV. BM MISSION DEF TP POOL DEFINITION
C CMEM DEFINITION BV DB VARIABLE DEF TV VAULT DEFINITION
BR RULE DEFINITION TI INQ/UPD MEDIA DB
BA RULE ACTIVITY TC CHECK IN EXT VOL

COMMANDS: X - EXIT, HELP, INFO OR CHOOSE A MENU OPTION 16.20.21

Entering =1 in the command line of any other screen returns you to the IOA Primary
Option Menu that is displayed at your site.

For a description of the options for other INCONTROL products, see the user guides
of the respective products.

Additional options available on the IOA Primary Option menu when operating
CONTROL-D and CONTROL-V with other INCONTROL products are listed in
Table 12.

Table 12 IOA Primary Option Menu Options (part 1 of 2)

Option Name Description
IV VARIABLE DATABASE Define, display and update IOA Database
variables used by CONTROL-O and
CONTROL-M.
Note: Option IV is available only at sites where CONTROL-O or CMEM are installed.
2 JOB SCHEDULE DEF Define or modify job production
parameters.
3 JOB STATUS Display and update status of jobs
scheduled under CONTROL-M.

88 CONTROL-D and CONTROL-V User Guide

 IOA Primary Option Menu

Table 12 IOA Primary Option Menu Options (part 2 of 2)

Option Name Description
C CMEM DEFINITION Define or modify CMEM rules.
Note: Options 2, 3, and C are available only at sites where CONTROL-M is installed.
BB BALANCING STATUS Display and update the status of active
balancing missions.
BM MISSION DEF Define balancing missions.
BV DB VARIABLE DEF Define, display and update Database
variables.
BR RULE DEFINITION Define balancing rules.
BA RULE ACTIVITY Display rule activity and the result of
invoking CONTROL-M/Analyzer rules.
Note: Options BB, BM, BV, BR, and BA are available only at sites where
CONTROL-M/Analyzer is installed.
OR RULE DEFINITION Define rules.
OM MSG STATISTICS View message statistics.
OS RULE STATUS View Rule Status screen.
OL AUTOMATION LOG Display commands, messages and/or
traces.
OA AUTOMATION OPTS Display available operator productivity
tools.
OC COSMOS STATUS Display or modify the status of
COSMOS-controlled objects and
databases.
OK KOA RECORDER Record VTAM scripts
Note: Options OR, OM, OS, OL, OA, OV, OC, and OK are available only at sites where
CONTROL-O is installed.
TR RULE DEFINITION Define rules.
TP POOL DEFINITION Define pools.
TV VAULT DEFINITION Define vaults.
TI INQ/UPD MEDIA DB Display Inquire/Update screen.
TC CHECK IN EXT VOL Check in external volumes.
Note: Options TR, TP, TV, TI, and TC are available only at sites where CONTROL-M/Tape
is installed.

IOA Version Information

Enter INFO (or I) in the OPTION field of the IOA Primary Option menu to display the
IOA Version Information window, as illustrated in Figure 10. This window lists the
version and level of each INCONTROL product installed at the site, plus the CPU ID
and current system date. The IOA Version Information window also identifies the
unique IOA QNAME assigned to the site. For further information about the IOA

Chapter 2 Online Facilities 89

Multi-Screen Control

QNAME, see the IOA operational parameters step, the IOAPLEX parameters step,
and the adding IOA structures to the CFRM step, all in the INCONTROL for z/OS
Installation Guide. Press Enter or END (PF03/PF15) to exit the window and return to
the IOA Primary Option menu.

Figure 10 IOA Version Information

--------------------- IOA PRIMARY OPTION MENU ------------------(1)
OPTION ===> USER N06

IOA CONTROL-D/V CONTROL-O

EssssssssssssssssssssssssssssssssssssssssssssssN
4 COND-RES IOA VERSION INFORMATION EFINITION
5 LOG ATISTICS
6 TSO IOA Version 6.1.00 TATUS
7 MANUAL CON IOAGATE Version 6.1.00 TION LOG
8 CALENDAR D CONTROL-M Version 6.1.00 TION OPTS
IV VARIABLE D CONTROL-M/RESTART Version 6.1.00 STATUS
CONTROL-M/ANALYZER Version 6.1.00 CORDER
CONTROL-M/TAPE Version 6.1.00
CONTROL-D Version 6.1.00
CONTROL-M & CTM CONTROL-V Version 6.1.00 ape
CONTROL-O Version 6.1.00
2 JOB SCHEDU EFINITION
3 ACTIVE ENV EFINITION
C CMEM DEFIN DATE 20.08.01 CPUID 02078D 7060 DEFINITION
IOA QNAME IOAR610 D MEDIA DB
IN EXT VOL
DssssssssssssssssssssssssssssssssssssssssssssssM

COMMANDS: X - EXIT, HELP, INFO OR CHOOSE A MENU OPTION 16.20.21

Multi-Screen Control
It is not necessary to return to the IOA Primary Option menu to move from one
online facility to another.

To speed up transfer of control between screens of different facilities and to enable

you to manage several online facilities at the same time, transfer control commands
can be specified. Transfer commands take you directly from your current screen to
the requested screen. Transfer commands can be used to reach any screen that can be
accessed through the IOA Primary Option menu at your site.

Each transfer control command consists of an equal sign immediately followed by the
option on the IOA Primary Option menu. The option identifies the target screen of
the transfer. For example, from any screen, specify:

Table 13 IOA Transfer Control Commands (part 1 of 2)

Command Description
=5 to access the IOA Log screen.
=4 to access the IOA Conditions/Resources screen.

90 CONTROL-D and CONTROL-V User Guide

 Fast Exit From the IOA Online Facility

Table 13 IOA Transfer Control Commands (part 2 of 2)

Command Description
=A to access the CONTROL-D/V Mission Status screen.
=1 to access the IOA Primary Option menu.

If you use a transfer command to reach another screen, the state of the current screen
remains unchanged when you return to it using another transfer command.

The INCONTROL administrator can globally deactivate any or all of the transfer
commands.

Fast Exit From the IOA Online Facility

To exit immediately from the IOA Online facility, type =X on the command line and
press Enter.

In most cases, the =X command has the same effect as pressing END (PF03/PF15) in all
open screens and then entering X (Exit) in the IOA Primary Option menu. Any
window, such as the Exit Option window, that would be displayed when exiting an
open screen is displayed when the =X command is entered.

However, when the =X command is entered while definition screens such as the
Calendar Definition screen are open, changes to the open definition screens are
cancelled. Changes currently in definition facility list screens, for example, changes to
previously closed definition screens, are not cancelled. Those screens and all other
open screens are treated as if END (PF03/PF15) has been entered.

NOTE
The =X command is intentionally not supported on certain screens.

Screen Layout
Most IOA screens are divided into four basic areas. The example used in this section
is the IOA Log screen.

Chapter 2 Online Facilities 91

Commands and PFKeys

Table 14 Basic IOA Screen Areas

Screen Area Description
Screen Description This line at the top of the screen describes the purpose of the screen
and Message Line (in the example screen, the IOA Log.) A screen identifier may
appear in the upper right corner (in the example screen, 5). This line
is also used to display messages.
Screen Header and This area is used for online commands, and, where applicable,
Command Area headings of the screen data.
Data Area On some screens, the data area can be scrolled. For more information,
see Scrolling Commands on page 95.
Screen Bottom This area of the screen usually contains a list of available commands
or options (In the example screen, SHOW, GROUP, CATEGORY,
and SHPF), or a brief explanation about screen usage. The current
time is displayed in the lower right corner.

Figure 11 IOA Log Screen

FILTER: ---------------- IOA LOG --------------------------------(5)
COMMAND ===> SCROLL===> CRSR
SHOW LIMIT ON ==> DATE 080800 - 080800
DATE TIME ODATE USERID CODE ------ M E S S A G E -------------------
080800 122330 080800 M24 SCD203I REP PRDKPLW4 ELIGIBLE FOR PROCESSING
080800 122330 080800 M18 SCD203I REP GPLIR17A ELIGIBLE FOR PROCESSING
080800 122330 080800 M24 REP267I PRDKPLW4 PRDKPLW4/JOB04800 DECOLLATION
FROM SPOOL STARTED
080800 122359 080800 M24 REP251I REP PRDKPLW4 PRDKPLW4/JOB04800
DECOLLATION ENDED "OK"
080800 122359 080800 M24 SCD208I REP PRDKPLW4 PROCESSING ENDED "OK"
080800 124634 080800 GENERAL CTD049I MISSION PROCESSING STARTED
080800 124635 080800 M24A CTD511I REP PLRPT010 ODATE 080800 PLACED ON
ACTIVE MISSIONS FILE-INVENTORY REPORT
080800 124635 080800 GENERAL CTD696I ALL MISSIONS PROCESSED SUCCESSFULLY
080800 124643 080800 M24 SCD203I REP PLRPT010 ELIGIBLE FOR PROCESSING
080800 124733 080800 M24 REP267I REP PLRPT010 PLRPT010/JOB04838
DECOLLATION FROM SPOOL STARTED
080800 124808 080800 M24 REP251I REP PLRPT010 PLRPT010/JOB04838
DECOLLATION ENDED "OK"
080800 124808 080800 M24 SCD208I REP PLRPT010 PROCESSING ENDED "OK"
080800 163335 080800 M22 CTD659I HOLD OF MISSION INTR0002 ODATE 080800
PERFORMED
CMDS: SHOW, GROUP, CATEGORY, SHPF 13.09.29

Commands and PFKeys

Commands are entered by typing a command in the COMMAND field and then
pressing Enter, or by pressing a predefined PFKey, or a combination of both.

It is not necessary to enter the full command name; the shortest unique abbreviation
of the command is sufficient. If the abbreviation is ambiguous, an appropriate
message is displayed in the message area.

92 CONTROL-D and CONTROL-V User Guide

 Commands and PFKeys

IOA commands are flexible; you can change command syntax or provide aliases
(synonyms) to suit your site. If you want to add or change a command syntax, consult
BMC Software Customer Support. The examples provided in this chapter exhibit the
original command syntax supplied with this INCONTROL product.

PFKey command assignments can be site-customized. It is possible to assign PFKeys

differently for each screen. To change PFKey command assignments, see your
INCONTROL administrator.

Supplied PFKey definitions are consistent throughout most of the screens. For
example: PF08/PF20 is used to scroll down (forward) on all INCONTROL screens
where scrolling is possible.

Table 15 Command PFKey Definitions

PFKey Description
PF01/PF13 HELP
PF02/PF14 SHOW (where applicable)a
PF03/PF15 END (exit current screen and go back one level)
PF04/PF16 RESET (where applicable)
PF05/PF17 FIND (where applicable)
PF06/PF18 =6 (transfer to TSO screen/application or to Utilities screen)b
PF07/PF19 UP (scroll backward)
PF08/PF20 DOWN (scroll forward)
PF10/PF22 LEFT or PREV (where applicable)
PF11/PF23 RIGHT or NEXT (where applicable)
PF12 RETRIEVE (Retrieves a sequence of commands and options entered by
the user during the current session. These commands and option are
displayed in reverse order, on the command line of the current screen.)
PF24 SHPF
a
When the IOA Online facility is activated in ISPF mode (that is, as an ISPF application),
PF02/PF14 are usually assigned the ISPF SPLIT command. For more information, see IOA
Under ISPF on page 99.
b
Disabled under ROSCOE/ETSO, CICS, VTAM, IMS/DC, IDMS/DC, COM-PLETE and TSO
cross memory option.

To see the PFKey assignment of the screen with which you are working, type
reserved command SHPF in the command line and press Enter. A window describing
the current PFKey assignment appears on the screen. Press Enter again to close the
window.

Chapter 2 Online Facilities 93

Commands and PFKeys

Figure 12 PFKey Assignment Widow

FILTER: ---------------- IOA LOG --------------------------------(5)
COMMAND ===> SCROLL===> CRSR
SHOW LIMIT ON ==> DATE 080800 - 080800
DATE TIME ODATE USERID CODE ------ M E S S A G E --------------------
080800 122330 080800 M24 SCD203I REP PRDKPLW4 ELIGIBLE FOR PROCESSING
080800 122330 080800 M18 SCD203I REP GPLIR17A ELIGIBLE FOR PROCESSING
080800 122330 080800 M24 REP267I PRDKPLW4 PRDKPLW4/JOB04800 DECOLLATION
FROM SPOOL STARTED
080800 122359 080800 M24 REP251I REP PRDKPLW4 PRDKPLW4/JOB04800
DECOLLATION ENDED "OK"
080800 122359 080800 M24 SCD208I REP PRDKPLW4 PROCESSING ENDED "OK"
080800 124634 080800 GENERAL CTD049I MISSION PROCESSING STARTED
+----------------------------------------------------------------------------+
| |
| ENTER ENTER PF13 HELP |
| PF01 HELP PF14 SHOW |
| PF02 SHOW PF15 END |
| PF03 END PF16 RESET |
| PF04 RESET PF17 FIND |
| PF05 FIND PF18 =6 |
| PF06 =6 PF19 UP |
| PF07 UP PF20 DOWN |
| PF08 DOWN PF24 SHPF |
| PF12 RETRIEVE |
+----------------------------------------------------------------------------+

If you type text in the COMMAND field and press a PFKey, the text in the
COMMAND field is treated as a subparameter of the command assigned to the
PFKey.

Two additional key definitions are:

Table 16 Additional Key Assignments

Key Description
PA1 ABORT (forced exit).
PA2 Under native TSO and ROSCOE, the first time you press this key, the
screen is refreshed. The second consecutive time, a copy of the screen is
sent to be printed (or to a file) via DD statement PRTDBG. (For terminal
models supporting PA3, PA3 is defined in exactly the same way as PA2.)

When the IOA Online facility is activated as an ISPF application, PA2 is

controlled by ISPF and only refreshes the screen. For information on
printing the screen, see IOA Under ISPF on page 99. Under other
online environments (CICS, VTAM, and so on), PA2 serves as a refresh
only. Usually one of the PA keys is assigned a local print function.

For information on changing IOA PFKey definitions, see the appendix in the
INCONTROL for z/OS Administrator Guide, which deals with modifying IOA Online
Facility Commands.

94 CONTROL-D and CONTROL-V User Guide

 Commands and PFKeys

Scrolling Commands
IOA scrolling conventions are very similar to IBMs ISPF conventions. Two basic
commands are used for scrolling:

Command PFKey Description

UP (PF07/PF19) Scroll up (backward)
DOWN (PF08/PF20) Scroll down (forward)

The commands can be specified by typing the command in the COMMAND field or
by pressing the predefined PFKey.

The scrolling amount is determined by the content of the SCROLL field in the right
corner of the screen header. Valid scrolling amounts are:

Table 17 Scrolling Amounts in the SCROLL Field

Scrolling Amount Description
PAGE Scroll a full page.
HALF Scroll a half page.
CRSR Scroll by cursor position. If the cursor is outside the data area, a full page
is scrolled.
MAX Scroll maximum available (for example, UP MAX scrolls to the top).

It is only necessary to type the first letter of the new amount in the SCROLL field in
order to change the scrolling amount.

A scrolling amount other than that shown in the SCROLL field can be used by
specifying the amount directly after the scroll command itself, or by specifying the
scroll amount in the COMMAND field and pressing the appropriate scrolling PFKey.
The scrolling amount in the SCROLL field remains unchanged.

Example

If PAGE is the value in the SCROLL field, to scroll to the bottom, type M (MAX) in the
COMMAND field and press PF08/PF20 (DOWN).

LOCATE Command
The LOCATE command, and its abbreviation, L, can be used to search for items in the
NAME field in all directory type screens that contain scrollable data, such as the
Calendar List screen. The syntax of the command is

LOCATE string

Chapter 2 Online Facilities 95

Commands and PFKeys

where string is the search string. Apostrophes (single quotes) or quotation marks
(double quotes) are not required.

The search proceeds from the top of the list to the first item in the list that starts with
the specified string. The cursor is positioned on the OPTION field at the beginning of
the line containing the string, if found, or on the OPTION field of the alphabetically
closest preceding value if the specified value is not found.

FIND Command
The FIND command, and its abbreviation, F, can be used in all screens that contain
scrollable data to find and display the next occurrence of a character string. The
syntax of the command is

FIND string [fromcol] [tocol] [PREV]

where

string is the search string

Mandatory.

fromcol is the first column in the search range

Optional.

tocol is the last column in the search range

Optional.

PREV is the indicator that the search must move backward, instead of forward, from
the current cursor position
Optional.

General Rules

If the string contains blanks, enclose the string with apostrophes (single quotes) or
quotation marks (double quotes). For example:

FIND 'WAIT SCHEDULE'

The column range searched can be limited by entering fromcol or tocol values, or by
entering both fromcol and tocol values.

The search for the string proceeds from the current cursor position forward, or
backward if PREV is entered. If the string is found, the cursor is positioned at the start
of the string.

To repeat the find, to the next or previous occurrence of the string, press PF05/PF17.

96 CONTROL-D and CONTROL-V User Guide

 Commands and PFKeys

NOTE
The following situations outline where the FIND command can, or should, be further
modified to enhance its functionality.

Some screens enable the user to limit the number of lines searched by a FIND command.
This is discussed in the relevant screen descriptions.

In some screens, the FIND command does not detect information that is to the right or left
of the information displayed in the monitor. To ensure detection of the desired string, the
screen must be displayed in wraparound mode, when available, before executing the
FIND command.

Text String Searches

The FIND command can also be used to search for text strings, in which case the
command finds all instances of the string, regardless of whether the characters within
the string are lowercase, uppercase, or mixed case. To search for a text string, include
the letter T immediately before a quoted string.

For example,

FIND T'WAIT SCHEDULE'

finds WAIT SCHEDULE, and it also finds wait schedule, and Wait Schedule, and any
other case variant.

Text string searches are the default. If your system default is for text strings, You do
not need to include the T if you perform a text string search. Your INCONTROL
administrator can change the default to character string. In this case you do not need
to include the C if you perform a character string search.

Character String Searches

The FIND command can be used to search for character strings, in which case the
command finds all instances of the string, but only where the string contains
characters that match the case specified. To search for a character string, include the
letter C immediately before a quoted string.

For example

FIND C'WAIT SCHEDULE'

finds WAIT SCHEDULE, but it does not find wait schedule, or Wait Schedule, or any
other case variant.

Chapter 2 Online Facilities 97

Online Help

CANCEL and RESET Commands

CANCEL and RESET commands are specified in the COMMAND field.

The CANCEL command cancels changes made in a definition screen, such as the IOA
Calendar Definition screen, and exits the screen.

The RESET command (PF04/PF16) cancels Edit environment options specified in a

definition screen. It does not cancel changes already made and it does not exit the
screen or cancel Edit environment mode. For more information about the Edit
environment, see Appendix A, Editing Mission Definitions in the IOA Edit
Environment.

The RESET command (PF04/PF16) can also be used in most windows, for example, the
IOA Log Show Screen window, to cancel changes and close the window.

Online Help
The following types of online help are available for INCONTROL screens:

Screen help
Provides information about the entire screen. This help is available on all
INCONTROL screens and is accessed by pressing the HELP key (PF01/PF13) while the
cursor is positioned on the COMMAND field in the screen.

Line-Sensitive help
Provides information about the fields on a particular line on a screen. This help is
available on several INCONTROL screens. It is accessed by pressing the HELP key
(PF01/PF13) while the cursor is positioned on the desired line of the screen.

If line-sensitive help is not supported in a screen, pressing the HELP key (PF01/PF13)
from anywhere in the screen displays the beginning of the Help panel.

98 CONTROL-D and CONTROL-V User Guide

 IOA Under ISPF

Figure 13 IOA Help Screen

----------------------------- IOA HELP SCREEN -------------------- (CTMHDT2 )
COMMAND ===> SCROLL===> CRSR

Calendar List Screen

====================

The Calendar List screen displays a list of calendars (members) in the

specified library. This screen can be entered directly from the entry
panel or upon exiting the Year List screen.

By default, only calendar names are listed in the screen. However, if

the default has been modified at time of installation, statistical
information is displayed for each calendar name.

Use the scrolling PFKeys to scroll forward (PF08/PF20) and backward

(PF07/PF19) on the Calendar List.

To return to the entry panel, press END (PF03/PF15).

Options of the Calendar List Screen

-----------------------------------
To request one of the following options, specify the option in the OPT

Help can be scrolled using standard scrolling conventions.

To return to the original screen, use the END command (PF03/PF15).

The Help member name appears on the right in the Help screen header. Members
containing the Help descriptions can be found in the IOA MSG library.

IOA Under ISPF

The IOA Online facility can be activated as an ISPF application. As such, it can work
in ISPF split screen mode like any other ISPF application.

WARNING
Multiple calls to the IOA ISPF interface can be performed in ISPF split screen mode as long as
all invocations are for the same IOA environment. Otherwise, the results may be
unpredictable.

The command line of the IOA Online facility is controlled by IOA. It is not possible to
enter ISPF commands in an IOA screen. Two ISPF commands must be defined to
PFKeys:

Chapter 2 Online Facilities 99

IOA Under ISPF

Table 18 ISPF Command Definitions for PFKeys

Command PFkey
SPLIT (usually PF02/PF14)
SWAP (usually PF09/PF21)

The rest of the PFKeys are controlled by IOA PFKey definitions, which are in the IOA
PARM library.

It is possible to assign TSO/ISPF commands such as PRINT to PFKeys, or to change

PFKey definitions by performing the following steps:

1 Exit from IOA and ISPF to the READY prompt.

2 Type the following command and press Enter:

ISPSTART PANEL(ISR@PRIM) NEWAPPL(CTM)

This command brings you to ISPF.

3 Type the KEYS command and press Enter. A set of key definitions is displayed.

4 Modify the key definitions as desired and exit from ISPF.

NOTE
ISPF KEY definitions for the following ISPF commands take precedence over IOA PFKey
definitions: SPLIT, SWAP, KEYS, PRINT, PFSHOW. For example, if PF02 is defined as
SPLIT in ISPF, an IOA definition for PF02 is ignored in online screens.

For all other ISPF commands, such as UP or DOWN, the key definitions in ISPF are
ignored and the PFKey is interpreted according to the definition in the IOA Online
facility.

Under ISPF, IOA Option 6 activates the Online Utilities panel, which is described
in IOA Online Utilities Menu on page 407. For more information about these
utilities, see the INCONTROL for z/OS Utilities Guide.

For more information on changing IOA PFKey definitions, see the appendix in the
INCONTROL for z/OS Administrator Guide that deals with modifying IOA Online
Facility Commands.

100 CONTROL-D and CONTROL-V User Guide

 IOA Editor

IOA Editor
The IOA Editor enables you to edit members of a partitioned dataset (PDS) using an
editor similar to the ISPF editor. Enter EDMEM in the command line of any screen to
display the Edit Entry Panel window, as shown in Figure 14.

Figure 14 IOA Editor Edit Entry Panel

--------------------- IOA PRIMARY OPTION MENU ------------------(1)
OPTION ===> USER N06

IOA CONTROL-D/V CONTROL-O

4 COND/RES A MISSION STATUS OR RULE DEFINITION

5 +--------------------------------------------------------------+ICS
6 | EDIT ENTRY PANEL |
7 | |LOG
8 | LIBRARY ==> |OPTS
IV | |US
| MEMBER ==> |R
| |
| FILL IN PARAMETERS AND PRESS ENTER TO CONTINUE OR PF3 TO EXIT|
CONTR| |
+--------------------------------------------------------------+
2 JOB SCHEDULE DEF BB BALANCING STATUS TR RULE DEFINITION
3 ACTIVE ENV. BM MISSION DEF TP POOL DEFINITION
C CMEM DEFINITION BV DB VARIABLE DEF TV VAULT DEFINITION
BR RULE DEFINITION TI INQ/UPD MEDIA DB
BA RULE ACTIVITY TC CHECK IN EXT VOL

COMMANDS: X - EXIT, HELP, INFO OR CHOOSE A MENU OPTION 19.12.05

To create a new member or edit an existing member, fill in the LIBRARY and
MEMBER parameters and press Enter. The IOA Editor screen is opened for editing, as
shown in Figure 15.

NOTE
If the member already exists in the specified library, the member is displayed for editing in the
IOA Editor. Similarly, if you accessed the IOA Editor screen from line option J in either screen
2 or screen 3, the member in the library referred to in the schedule definition member is
displayed for editing.

Chapter 2 Online Facilities 101

IOA Editor

Figure 15 IOA Editor

---------------------------- I O A E D I T O R ------------------- (EDMEM)
COMMAND ===> SCROLL===> CRSR
ROW PROD.V610.DEMO(TEST) COL 001 072

......
......
......
......
......
......
......
......
......
......
************************ B O T T O M O F D A T A **************************

OPTIONS: I INSERT D DELETE R REPEAT C COPY M MOVE UC/LC UPPER/LOWER CASE

IOA Editor PFKey Functions

While working within the IOA Editor, PFKeys perform the functions shown in
Table 19:

Table 19 PFKey Functions Within the IOA Editor Screen

PFKeys Description
PF01/PF13 Activates online help.
PF02/PF14 Saves the current member.
PF03/PF15 Terminates the editing session. If the edited member has been
changed the member is saved automatically.
PF04/PF16 Cancels the editing session without saving changes.
PF05/PF17 Invokes the Find facility.
PF07/PF19 Scrolls forward.
PF08/PF20 Scrolls backward.
PF10/PF22 Scrolls left.
PF11/PF23 Scrolls right.

Commands of the IOA Editor Screen

Table 20 describes editing commands that can be executed by entering the command
in the COMMAND line.

102 CONTROL-D and CONTROL-V User Guide

 IOA Editor

Table 20 IOA Editor Command Line Commands

Command Description
SAVE Saves all new data without terminating the edit session.
CANCEL Terminates the edit session without saving new data.
COPY Enables you to import a member from a specific library.

Table 21 describes editing commands that can be executed by entering the command
in the leftmost position of the applicable row.

Table 21 IOA Editor Row Commands (part 1 of 2)

Command Description
I Inserts a new line below the current line.
To insert more than one line for new data, enter Inn, where nn
indicates the number of new lines to be inserted below the current
line.
D Deletes the current line.
To delete more than one line, enter Dnn, where nn indicates the
number of lines to be deleted below the current line.
You can delete a block of lines by typing DD at the beginning of the
first line of the block, and then entering DD at the beginning of the
last line of the block.
R Repeats the current line.
To repeat a single line one or more times, enter Rnn, where nn
indicates the number of times the current line is to be repeated.
You can repeat a block of lines by typing RR at the beginning of the
first line of the block, and then entering RR at the beginning of the
last line of the block.
C Identifies the source line for a copy operation.
To copy more than a single line, enter Cnn, where nn indicates the
number of lines to be copied.
You can also copy a block of lines by typing CC at the beginning of
the first line of the block, and then entering CC at the beginning of
the last line of the block.
M Identifies the source line for a move operation.
To move more than a single line, enter Mnn, where nn indicates the
number of lines to be moved.
You can also move a block of lines by typing MM at the beginning of
the first line of the block, and then entering MM at the beginning of
the last line of the block.
A Identifies the destination of a copy or move operation.
When a line or block of lines has been selected for copying or
moving, enter A at the point after which the copied lines are to be
inserted.
B Identifies the destination of a copy or move operation.
When a line or block of lines has been selected for copying or
moving, enter B at the point before which the moved lines are to be
inserted.

Chapter 2 Online Facilities 103

IOA SET Command Panel

Table 21 IOA Editor Row Commands (part 2 of 2)

Command Description
LC Changes text in a line from uppercase to lowercase.

To change text in more than a single line to lowercase, enter LCnn,

where nn indicates the number of lines to be changed to lowercase.
UC Changes text in a line from lowercase to uppercase.

To change text in more than a single line to uppercase, enter UCnn,

where nn indicates the number of lines to be changed to uppercase.

IOA SET Command Panel

The IOA SET Command Panel enables you to set and stop TRACE levels, choose the
language that is used in online screens and to set a dollar sign representation that will
be used in online screens for system variables of type %%$VAR. Enter SET in the
command line of any screen to display the SET Command Panel window, as shown
in Figure 16.

Figure 16 IOA SET Command Panel

+-----------------------------------------------------------------------------------+
| SET Command Panel |
| |
| |
| TRACE level , ON (Trace level 001-512, ON or OFF) |
| |
| |
| LANGUAGE ENG - English |
| FRA - French |
| GER - German |
| JPN - Japanese |
| |
| |
| SPECIAL CHARACTERS: Dollar Current representation is "$"(X'5B') |
| |
| |
| FILL IN PARAMETERS AND PRESS ENTER TO CONTINUE OR PF3 TO EXIT |
| |
+-----------------------------------------------------------------------------------+

The process of setting TRACE levels and turning off a particular TRACE, and the
process of setting language preferences for online screens and messages, begins in the
SET Command Panel.

Using the SET Command Panel to set and end TRACE levels
Setting the TRACE level can help you monitor certain IOA Online facility and
INCONTROL functions, such as security checks.

104 CONTROL-D and CONTROL-V User Guide

 IOA SET Command Panel

The following steps explain how to set or turn off a TRACE level:

1 Type a TRACE level number, from 1 through 256, in the TRACE LEVEL field of the
SET Command Panel.

2 In the (Trace level 1-256, ON or OFF) field, type ON to set a TRACE level, or OFF to
turn off a TRACE level.

3 Press Enter to confirm the setting, in which case the following message is
displayed:

CTMA2AI TRACE LEVEL nnn WAS SET xxx

where

nnn is the TRACE level number

xxx indicates whether the TRACE level was set ON or turned OFF

NOTE
TRACE level settings take effect immediately.

Using the SET Command Panel to set a dollar sign

representation
Setting the dollar sign representation influences how System variables are shown in
online screens.

The following steps explain how to set the dollar sign representation:

1 Type a $ character in the Dollar field using your keyboard.

2 Press Enter to confirm the setting, in which case the following message is
displayed:

CTMA2DI THE NEW DOLLAR REPRESENTATION IS "c"(X'yy')

where

c is $ character you set

yy is the EBCDIC hexadecimal code for $

NOTE
There are differences in the EBCDIC hexadecimal code for the $ (dollar sign) character on
keyboards that have been adapted to show local or national symbols.

Chapter 2 Online Facilities 105

IOA TSO Command Processor Screen

Using the SET Command Panel to set language preferences

Setting the LANGUAGE influences the online screens and messages in subsequent
sessions.

The following steps explain how to set language preferences:

1 In the LANGUAGE field, type one of the following sets of characters to select a
language preference:

ENG, to set English as the preferred language

FRA, to set French as the preferred language
GER, to set German as the preferred language
JPN, to set Japanese as the preferred language

2 Press Enter to confirm the setting, in which case the following message is
displayed:

CTMA27I THE NEW LANGUAGE WILL BE USED FROM THE NEXT LOGON TO
IOA

NOTE
Language preference settings do not take effect until your next logon to the system.

IOA TSO Command Processor Screen

The IOA TSO Command Processor screen can be entered only when the IOA Online
facility is activated as a TSO application. It cannot be entered when the IOA Online
facility is activated as an ISPF application or activated under a non-TSO environment.

The TSO screen enables activation of any TSO command without exiting the IOA
Online facility. For example, a typical program activated under the TSO screen is
ISPF. Therefore, all ISPF/PDF facilities and functions (such as editing a member or
scanning job output) can be activated while you are working under the IOA Online
facility.

To activate a TSO command, type the command in the COMMAND field and press
Enter.

Figure 17 IOA TSO Command Processor Screen

-------------------------- IOA TSO COMMAND PROCESSOR ----------------------(6)
COMMAND ===>

106 CONTROL-D and CONTROL-V User Guide

 IOA TSO Command Processor Screen

PLEASE ENTER TSO COMMAND 15.32.52

NOTE
CLISTs cannot be activated from the TSO screen. To activate a CLIST, first activate ISPF and
then execute the CLIST under ISPF.

TSO commands can also be activated directly from any online screen by typing TSO
in the COMMAND field.

Transfer of Control Between the TSO Application and the

IOA Online Facility
You can return to the IOA Online facility from the TSO application by simply exiting
the TSO application in a normal manner. However, this method may be time
consuming and inconvenient if an ISPF application or similar TSO application is
activated.

If the TSO application can issue a TSO command, it is possible to transfer control to
the IOA Online facility, and vice versa, without exiting the TSO application.

While working under the TSO application, for example, under ISPF, issue the
command:

TSO CTMTTRA {n | =n}

where n is the online screen number. The requested screen is displayed as it was
when you transferred from it.

Chapter 2 Online Facilities 107

Report Decollating Mission Definition Facility

To return to the TSO application, use the =6 command (PF06/PF18). The application
remaining in the same state as when you transferred from it.

It is recommended that you simplify transfer between screens by permanently

assigning one of your PFKeys under ISPF (or SDSF, and so on) to the command TSO
CTMTTRA. Once this key assignment is made, you no longer need to type the full
transfer command. Instead, you merely type the IOA option number or code in the
COMMAND field and press the assigned PFKey. You are transferred to the desired
screen.

NOTE
You must activate ISPF under the IOA Online facility if you want to use the control transfer
feature.

Report Decollating Mission Definition Facility

The CONTROL-V Report Decollating Mission Definition facility is composed of a
series of screens that enable you to view, create, and modify report decollating
missions and parameters.

Report decollating mission definitions under CONTROL-V are stored in libraries

(partitioned datasets). A library contains members (also referred to as jobs or report
names), and each member contains categories of one or more mission definitions. A
member generally contains decollating mission definition categories related to
specific topics. When CONTROL-M is installed and a member contains decollating
mission definitions that process output from CONTROL-M jobs, the member name
should correspond to the jobname as defined in each of its decollating mission
definitions. For mission definitions that process output from non-CONTROL-M jobs,
there is no such restriction for the member name. Although most sites designate a
primary mission definition library, the number of mission definition libraries that
you can use is unlimited.

NOTE
Members contain mission definitions not the JCL of the member.

The number of members in a library, the number of mission definitions in a member,

and the size of each mission definition, are all calculated dynamically and are not
dependent on parameter specification or optional ZAPs.

108 CONTROL-D and CONTROL-V User Guide

 Accessing the Report Decollating Mission Definition Facility

Accessing the Report Decollating Mission Definition Facility

The Report Decollating Mission Definition facility contains the following screens:

Table 22 Report Decollating Mission Definition Facility Screens

Screens Definition
Mission Definition entry panel Allows specification of parameters which determine
which screen is displayed.
Job List screen Displays the list of members in the specified library.
Category List screen Displays the list of mission definitions in a specific job
table.
Mission Definition screen Displays the parameters of the selected mission
definition. This screen is used to define, display and
modify mission definition parameters.

To enter the Report Decollating Mission Definition facility, select option R on the IOA
Primary Option menu and press Enter. The entry panel is displayed.

Creating Members
Members can be created in any of the following ways:

By specifying the new member name in the entry panel and pressing Enter.

By using the SELECT command (described later) to specify the new member name
in the Job List screen and pressing Enter.

As a result of using either of the above methods, a skeletal mission definition (that
is, one with most fields not filled in) is displayed in the Mission Definition screen.

Fill in the blanks and save the screen entries. The member is created with the
specified mission definition. The mission definition is the first and only definition in
the Category list for the member. As additional mission definitions are created in the
member (described below), they are added to the Category list.

NOTE
Upon exiting the Category List screen, if changes were made in at least one mission definition,
an Exit Option window is displayed. One field of the window displays the member name.
This value can be changed to a new member name. This creates a new member in which the
mission definitions are saved.

Chapter 2 Online Facilities 109

Creating Mission Definitions

Creating Mission Definitions

Mission definitions can be created using two basic methods:

A skeletal mission definition can be created by specifying the name of a new

mission definition in the entry panel. (The member specified in the entry panel can
be either a new member or an existing member.) In this case, virtually all fields of
the mission definition are empty.

A copy of an existing mission definition can be created using the INSERT option
(described later) in the Category List screen. In this case, most fields of the new
mission definition have the same values as the fields in the copied mission
definition.

Performing Operations on Members and Mission Definitions

Many operations can be performed on members and on the mission definitions in
them. These operations are performed using commands and options in the various
screens of the Report Decollating Mission Definition facility.

Below is a brief summary of some of the major operations possible within the facility.
Options and commands that have not yet been explained are explained in detail
following the summary.

Accessing (Editing or Browsing) a Member and its Mission

Definitions
A member (that is, the mission definitions in the member) can be browsed or edited.

When browsed, the member cannot be modified or updated. When the member is
edited, new mission definitions can be added and existing mission definitions can be
modified or deleted.

Browsing, however, has advantages:

Access and exit are quicker than in editing.

Mission definitions that are in use by another user can be viewed.
Access for browsing might be granted, even though access for editing might be
denied due to site security requirements.

To browse a member (and its category list and mission definitions), use the BROWSE
option in the Job List screen.

110 CONTROL-D and CONTROL-V User Guide

 Entry Panel

Specifying the job (member) name in the entry panel or using the SELECT option in
the Job List screen provides edit access.

Depending on user profile definitions, if the table requested for editing is in use,
either access is granted in Browse mode or access is not granted.

Copying a Mission Definition to Another Member

Mission definitions can be copied from one member to another using the COPY
option in the Category List screen. For more information, see Copying Report
Decollating Mission Definitions to Another Member on page 138.

Deleting a Member or a Mission Definition

Unneeded mission definitions can be deleted via the DELETE option in the Category
List screen. For more information, see Options of the Category List Screen on
page 119. Unneeded members can be deleted via the DELETE option in the Job List
screen. For more information, see Deleting Members on page 116.

Ordering Multiple Members

More than one member at a time can be ordered at one time. To select multiple
members, Tab down to each table in the Job List screen that you want to select and
enter the letter O next to the desired member. Press Enter. A popup confirmation
window appears that asks whether or not you want to view the confirmation window
for each member.

If you choose not to view the confirmation screen before viewing each member
(Confirm Y, Ask For Each One N), press Enter.

Saving Modifications
All changes made to a member and its mission definitions are kept in memory until
the member is exited. Upon exiting the member, the user can choose to save or cancel
the changes. For more information, see Exiting the Mission Definition Screen on
page 166.

Entry Panel
To open the desired display, fill in Entry Panel fields LIBRARY, JOB, and CATEGORY
as described below. Type Y (Yes) or N (No) in the SHOW SCHEDULING CRITERIA
field to determine whether scheduling parameters appear when the Report
Decollating Mission Definition screen is displayed.

Chapter 2 Online Facilities 111

Entry Panel

Figure 18 Report Decollating Mission Definition Facility Entry Panel

------- CONTROL-D/V REPORT DECOLLATING MISSION DEFINITION ENTRY PANEL -----(R)
COMMAND ===>

SPECIFY LIBRARY, JOB/REPORT NAME, CATEGORY

LIBRARY ===> CTD.PROD.REPORTS

JOB ===> (Blank for job selection list)
CATEGORY ===> (Blank for category selection list)

SHOW SCHEDULING CRITERIA ===> N (Y/N)

USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT 13.11.20

NOTE
If you use the selection list fields, their values are not erased until you exit the entry panel by
pressing END (PF03/PF15).

To display the list of members (jobs) in a library

1 Type the library name.

2 Leave the member (job) name blank or type the member (job) name using mask
characters (* and ?).

3 Press Enter.

To display the list of mission definitions for a specific member

1 Type the library name.

2 Type the member name.

3 Press Enter.

If the member does not exist, the screen for defining a new mission definition in the
member is displayed.

112 CONTROL-D and CONTROL-V User Guide

 Entry Panel

To display the details of a specific mission definition (Mission Definition

screen)

1 Type the library name

2 Type the job (member) name.

3 Type the mission definition (category) name.

4 Press Enter.

If the member does not exist, or the mission definition for the specified member does
not exist, the screen for defining a new mission definition in the member is displayed.

NOTE
If you enter the screen for defining a new mission definition and want to leave the screen
without defining a mission definition, use the CANCEL command.

To display the Search Window

1 Type the library name.

2 Type the mission definition (category) name.

3 Leave the member name blank or type the member name using mask characters (*
or ?).

4 Press Enter.

To create a new member

1 Type the library name.

2 Specify a new job (member) name.

3 Press Enter.

The Mission Definition screen, for defining the first mission definition in the new
member, is displayed.

Search Window
The Search window allows the user to search for the specified mission definitions in
members in the specified library. Members in which the mission definition have been
found are then displayed in the Job List screen.

Chapter 2 Online Facilities 113

Entry Panel

Figure 19 Report Decollating Mission Definition Facility Entry Panel

Search Window
- CONTROL-D/V REPORT DECOLLATING MISSION DEFINITION FACILITY - ENTRY PANEL--(R)
COMMAND ===>

SPECIFY LIBRARY, JOB/REPORT NAME, CATEGORY

LIBRARY ===> CTD.PROD.SCHEDULE

JOB ===> (Blank for job selection list)
CATEGORY ===> CTVSAMPLE (Blank for category selection list)
+-------------------------------------------+
| |
| PLEASE SELECT ONE OF THE FOLLOWING: |
| |
| 1 - STOP SEARCH IMMEDIATELY |
| 2 - ASK AGAIN AFTER 000010 MEMBERS |
SHOW SCHEDULING CRITERIA ===> | 3 - UNCONDITIONAL SEARCH |
| |
| NUMBER OF MEMBERS IN LIBRARY: 000015 |
| NUMBER OF SEARCHED MEMBERS: 000000 |
| NUMBER OF SELECTED MEMBERS: 000000 |
| |
+-------------------------------------------+
USE THE COMMAND SHPF TO SEE PFK ASSIGNMENT 12.11.54

To close the Search Window without performing any action, press END (PF03/PF15).

To perform a search, select one of the following choices and press Enter:

3 - UNCONDITIONAL SEARCH

Performs an uninterrupted search of all tables in the specified library.

The search is stopped immediately when you select option 1.

2 - ASK AGAIN AFTER number MEMBERS

Searches the specified number of members in the specified library, and then pauses.
The search number can be modified. Default:10.

Continue the search by pressing Enter.

Stop the search by selecting option 1 (Stop Search Immediately).

If any members are found, the Job List is displayed listing those members.

During the search, the following information is displayed at the bottom of the
window:

114 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Job List

Number of members in library. Lists the total number of members in the specified
library.

Number of searched members. Lists the cumulative number of members

searched. For example, if you perform three searches with a specified number of
10, the figure displayed is 30.

Number of selected members. Lists the cumulative number of members selected

that contain the mission definition being searched.

If any members are selected during the search, the Job List is displayed listing those
members. If no members are selected, the Search Window is closed and a message is
displayed.

Report Decollating Mission Definition Job List

The screen displays the list of members in the specified library. This screen can be
entered directly from the entry panel or upon exiting the Category List screen.

By default, only member names are listed in the screen. However, if the default has
been modified at time of installation, statistical information is displayed for each
member name (as shown in Figure 20).

Figure 20 Report Decollating Mission Definition Facility Job List Screen

LIST OF JOBS LIB: CTD.PROD.REPORTS ----------------
COMMAND ===> SCROLL===> CRSR
OPT NAME ------------ VV.MM CREATED CHANGED SIZE INIT MOD ID
PRDKPL01 01.00 00/08/08 00/08/08 16:54 18 18 0 M04B
PRDKPL02 01.00 00/08/08 00/08/08 16:54 20 20 0 M04B
PRDKPLW1 01.01 00/11/24 00/11/24 12:17 9 9 0 M35A
PRDKPLW2 01.00 00/06/30 00/06/30 09:54 12 12 0 V309
PRDKPLW3 01.02 00/11/22 00/11/22 11:04 6 6 0 M72
PRDKPLW4 01.01 00/11/27 00/11/27 13:33 8 8 0 M18C
PRDLRPT1 01.00 00/04/17 00/04/17 00:50 70 70 0 O01
PRDLRPT2 01.00 00/04/17 00/04/17 00:50 180 180 0 O01
PLRPT010 01.00 00/04/17 00/04/17 00:50 41 41 0 O01
PRODYALT 01.00 00/04/17 00/04/17 00:50 5 5 0 S07
PRODYHST 01.00 00/04/17 00/04/17 00:50 9 9 0 S07
PRODYJCL 01.00 00/04/17 00/04/17 00:50 14 14 0 S07
PRODYRPT 01.00 00/04/17 00/04/17 00:50 5 5 0 S07
QNTR0001 01.01 00/11/24 00/11/24 12:17 9 9 0 M35A
QNTR0002 01.00 00/06/30 00/06/30 09:54 12 12 0 V309
RBDMM4D 01.02 00/11/22 00/11/22 11:04 8 6 0 M72
RTUPDT 01.01 00/11/27 00/11/27 13:33 8 8 0 M18C
STPRQV 01.00 00/04/17 00/04/17 00:50 70 70 0 O01
TRUPDOLV 01.00 00/08/08 00/08/08 16:54 18 18 0 M04B
UPLIR17A 01.00 00/08/08 00/08/08 16:54 20 20 0 M04B
OPTIONS: S SELECT O ORDER F FORCE B BROWSE D DELETE 14.39.49

To scroll down the Job list, press PF08/PF20. To scroll up the Job list, press
PF07/PF19.

Chapter 2 Online Facilities 115

Report Decollating Mission Definition Job List

To return to the entry panel, press END (PF03/PF15).

Options of the Job List Screen

To request one of the following options, specify the option in the OPT field to the left
of the member names and press Enter:

Table 23 Options of the Job List Screen

Option Description
S (SELECT) Display the list of mission definitions of the member for any purpose,
including editing and modification. Only one member can be selected at a
time.
O (ORDER) Order all the mission definitions of the member, provided that their basic
scheduling criteria (discussed later in this chapter) are met. Multiple
members can be ordered.
F (FORCE) Order all the mission definitions of the member, regardless of their basic
scheduling criteria (discussed later in this chapter). Multiple members can
be forced.
B (BROWSE) Display a list of mission definitions of a member for browsing. Only one
member can be browsed at a time.
D (DELETE) Delete the member from the library. Multiple members can be deleted.

NOTE
The INCONTROL administrator can authorize specific users to access only the Browse option.

Deleting Members
To delete members specify option D in the OPT field to the left of the members to be
deleted and press Enter.

The following confirmation window is displayed, in sequence, for each member

selected for deletion.

116 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Category List

Figure 21 Report Decollating Mission Definition Facility Delete Members

Confirmation Window
LIST OF JOBS LIB: CTD.PROD.REPORTS ----------------
COMMAND ===> SCROLL===> CRSR
OPT NAME ------------ VV.MM CREATED CHANGED SIZE INIT MOD ID
ACCTNG01 01.00 00/08/08 00/08/08 16:54 18 18 0 M04B
ACCTNG02 01.00 00/08/08 00/08/08 16:54 20 20 0 M04B
ACCTNGW1 +--------------------------+
ACCTNGW2 | CONFIRM DELETE OPTION |
D ACCTNGW3 <-----------| (Y/N) | 6 6 0 M72
ACCTNGW4 +--------------------------+ 8 8 0 M18C
ADMINST1 01.00 00/04/17 00/04/17 00:50 70 70 0 O01
ADMINST2 01.00 00/04/17 00/04/17 00:50 180 180 0 O01
PERSNL10 01.00 00/04/17 00/04/17 00:50 41 41 0 O01
D PERSNLDK 01.00 00/04/17 00/04/17 00:50 5 5 0 S07
PERSNLST 01.00 00/04/17 00/04/17 00:50 9 9 0 S07
PRODTNCL 01.00 00/04/17 00/04/17 00:50 14 14 0 S07
PRODTNTL 01.00 00/04/17 00/04/17 00:50 5 5 0 S07
D RESTOR01 01.01 00/09/25 00/09/25 12:17 9 9 0 M35A
RESTOR02 01.00 00/06/30 00/06/30 09:54 12 12 0 V309
SALES4D 01.02 00/09/22 00/09/22 11:04 8 6 0 M72
SALEST 01.01 00/09/26 00/09/26 13:33 8 8 0 M18C
SALESV 01.00 00/04/17 00/04/17 00:50 70 70 0 O01
TRAIN001 01.00 00/08/08 00/08/08 16:54 18 18 0 M04B
TRAIN001 01.00 00/08/08 00/08/08 16:54 20 20 0 M04B
OPTIONS: S SELECT O ORDER F FORCE B BROWSE D DELETE 14.39.49

Enter Y (Yes) in the window to confirm the delete request.

Enter N (No) in the window to cancel the delete request.

NOTE
If PDSMAN is operational at your site, $$$SPACE members are not deleted.

A message is written to the IOA Log file for each member deleted.

Report Decollating Mission Definition Category List

The screen displays the list of mission definitions of a member in a specified library.
This screen can be entered directly from the Report Decollating Mission Definition
entry panel or the Job List screen, or upon exiting the Mission Definition screen.

NOTE
If the S (Select) option was specified in the Job List screen for a member that is currently in use
(selected) by another user, then either the Category List screen is not displayed and the Job
List screen remains displayed (the default), or the Category List screen is displayed in Browse
mode (if a User profile definition overrides the default). In either case, an appropriate message
is displayed.

Chapter 2 Online Facilities 117

Report Decollating Mission Definition Category List

Figure 22 Report Decollating Mission Definition Category List Screen

CATEGORIES OF LIB CTD.PROD.REPORTS JOB: PLRPT010
COMMAND ===> SCROLL===> CRSR
OPT NAME --------------------------------------------------------------------
DAILY INVENTORY AND EMPLOYEE REPORTS - DAILY
MONTHLY INVENTORY AND EMPLOYEE REPORTS - MONTHLY
====== >>>>>>>>>>>>>> NO MORE CATEGORIES FOR THE JOB <<<<<<<<<<<<<<<<< =====

OPTIONS: S SELECT D DELETE I INSERT O ORDER F FORCE 13.43.00

Use the scrolling conventions to scroll forward and backward through the Category
list.

Format of the Category List Screen

Next to each mission definition name in the Category list, certain information can be
displayed. The type and format of this information depends on whether the screen is
displayed in DESC format or in STAT format:

In DESC format, the mission definitions description, taken from the DESC field of
the mission definition, is displayed. Default.

In STAT format, the mission definitions ISPF statistical information is displayed.

By default, the Category list is displayed in DESC format. To change formats, use the
DESC or STAT commands, described in Table 24.

118 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Category List

Commands of the Category List Screen

The following commands can be specified in the COMMAND field of the Category
List screen.

Table 24 Commands of the Category List Screen

Command Description
DESC Command DESC displays the mission definitions description next to the
mission definition name. The description is taken from the DESC field in
the mission definition.
STAT Command STAT displays the following ISPF-like statistical information
about the mission definition next to the mission definition name: Version
and modification numbers, creation date, last modification date, and
user ID

Options of the Category List Screen

To request one of the following options, specify the option in the OPT field to the left
of the mission definition name and press Enter:

NOTE
If the Category List screen is displayed in Browse mode, options D (Delete) and I (Insert) are
not available.

Table 25 Options of the Category List Screen (part 1 of 2)

Option Description
S (SELECT) Display the Report Decollating Mission Definition screen, which
contains decollating parameters of the specific mission definition.

If the Mission Definition screen is not displayed in Browse mode, the

decollating parameters can be edited and updated. If the Mission
Definition screen is displayed in Browse mode, the decollating
parameters can only be browsed; they cannot be modified.
D (DELETE) Delete a mission definition from the Category list.
I (INSERT) Insert a new mission definition in the List. The Mission Definition screen
appears, with the same details of the mission definition marked I, but
the CATEGORY and DESCRIPTION parameters are empty for you to fill
in. The new mission definition is added after the mission definition
marked I.
O (ORDER) Order a mission definition of a member based on the basic scheduling
criteria. For more information, see Basic Scheduling Parameters on
page 125.

Chapter 2 Online Facilities 119

Report Decollating Mission Definition Screen

Table 25 Options of the Category List Screen (part 2 of 2)

Option Description
F (FORCE) Force a mission definition order regardless of its basic scheduling
criteria. For more information, see Basic Scheduling Parameters on
page 125.
C (COPY) Copy the mission definition to another member (as described in
Copying Report Decollating Mission Definitions to Another Member
on page 138). Multiple mission definitions can be copied.

Report Decollating Mission Definition Screen

This screen is used to define, display and modify decollating parameters of the
reports of a specific mission definition. This screen can be entered directly from the
Report Decollating Mission Definition entry panel or from the Category List screen.
Update of parameters is not permitted in Browse mode.

CONTROL-V indexing instructions are included in the decollating parameters.

Decollating parameters take up more than one screen. Use the scrolling conventions
to scroll the decollating parameters forward and backward.

For a detailed explanation of the decollating parameters, refer to Chapter 3,

Decollating Mission Parameters.

NOTE
Parameters marked in this documentation with the symbol M can have many occurrences.
Whenever you fill in the last occurrence of the parameter on the screen, CONTROL-V adds a
new empty occurrence of that parameter which you may fill in. The only limit to the number
of occurrences is the region size available for the application.

To delete a parameter on the screen, simply erase it (press the EOF key or blank it
out). If additional operations are required, CONTROL-V issues appropriate
instructions.

Report decollating mission parameters are divided into the following basic groups
indicated on the following screen:

General parameters
Basic Scheduling parameters
Runtime Scheduling parameters
Post-processing parameters
Decollating parameters (including indexing instructions)

The groups are separated by a delimiter line.

120 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Screen

The decollating parameters are organized in ON blocks. Each ON block contains

decollating instructions for those reports that are defined in the ON statement.

Figure 23 Report Decollating Mission Definition Screen

----- CONTROL-D/V CATEGORY DAILY JOB M15ACC ---------- (R.S)
COMMAND ===> SCROLL===> CRSR
+---------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT10 GENERIC N MONITOR 1
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE REPORTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN PLRPT010-ENDED-OK 0909
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
MSG ==== REPORT DECOLLATION FOR PLRPT010 ENDED NOTOK ====
===========================================================================
DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES 10
===========================================================================
SET = %% = C CS
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT N CT AND/OR O
STRING = E M P L O Y E E S R E P O R T
DO INDEX = EMNUM M R G LINE +00000 COL 00011 - 00014
MASK = #### RC Y LINE 00002 - 00060 COL 00011 - 00014
02 SUBINDX = EMPNAME M LVL 02 LINE +00000 COL 00016 - 00035
MASK = * RC Y LINE 00002 - 00060 COL 00016 - 00035
03 SUBINDX = EMPGRADE M LVL 03 LINE +00000 COL 00037 - 00040
MASK = #### RC Y LINE 00002 - 00060 COL 00037 - 00040
SUBINDX = M LVL LINE COL -
MASK = RC LINE - COL -
===========================================================================
INDEX LEVEL DISPLAY
EMPNUM / EMPNAME / EMPGRADE
===========================================================================
DO USER = * LVL LINE COL 00064 - 00074
S N T SYNONYM = CONCAT =
DO NAME = EMPLOYEES REPORT
DO MIGRATE = MIG005Y
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
====== >>>>>>>>>> END OF JOB/REPORT PARAMETERS FOR THIS CATEGORY <<<<<<< ====
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 12.32.12

Chapter 2 Online Facilities 121

Report Decollating Mission Definition Screen

CAPS Command
By default, all entries of lowercase characters in the Report Decollating Mission
Definition screen are converted and saved as uppercase. You can use the CAPS OFF
command to enable certain fields to accept and save lowercase entries.

Valid formats of the CAPS command are:

Table 26 CAPS Command Formats

Command Description
CAPS Indicates whether CAPS ON or CAPS OFF mode is active.
CAPS ON Forces all user entries to be displayed in uppercase characters,
regardless of the case in which they were entered. Default.
CAPS OFF Enables user entries in certain parameters to be entered, saved, and
displayed in lowercase.

The CAPS OFF command is available only for the following parameters and
subparameters:

Table 27 Parameters and Subparameters Accepting Lowercase Values

Parameter Description
DO NAME All values can be entered and retained in lowercase.
DO REMARK All values can be entered and retained in lowercase.
DO REMARK2 All values can be entered and retained in lowercase.
DO REMARK3 All values can be entered and retained in lowercase.
DO INDEX All values of the MASK subparameter can be entered and
retained in lowercase.
SET All values of the %%VAR subparameter for user-defined
variables can be entered and retained in lowercase.
DO SET All values of the %%VAR subparameter for user-defined
variables can be entered and retained in lowercase.
PRINT/CDAM PARMS All values of the XMLSEP subparameter can be entered and
retained in lowercase.
WHEN LINE All values of the STRING subparameter can be entered and
retained in lowercase.
WHEN VAR All values of the STRING subparameter can be entered and
retained in lowercase.

When you first enter a decollation mission definition screen, the CTOD78I message is
displayed with the current CAPS setting. The CTOD78I message is also displayed,
with the current ON or OFF status, whenever you enter the CAPS command.

122 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Screen

Display and Non-Display of Scheduling Criteria

When N has been entered in the SHOW SCHEDULING CRITERIA field of the Report
Decollating Mission Definition entry panel, all General, Basic Scheduling, Runtime
Scheduling and Post-processing parameters are hidden except the Category line of
the General parameters. The SET lines of Decollating parameters are also hidden.

The Category line is displayed, followed by the decollating parameters.

Figure 24 Non-Display of Scheduling Criteria

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ---------(R.S)
COMMAND ===> SCROLL===> CRSR
+----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC MONITOR
===========================================================================
DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00014 COL 00014 - 00046 PRINT Y REF NXT N CT N AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT
DO USER = * LVL LINE COL 00064 - 00074
S N T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0007D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
ON DSN = DDNAME=PLREP4,PGMSTEP=PLRP0010
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 11.42.50

NOTE
When defining report decollating missions, it is customary to work with the scheduling
criteria hidden.

SCHED Command
Typing SCHED (abbreviated SC) in the command line alternates between the display
and non-display of the scheduling parameters (independent of the SHOW
SCHEDULING CRITERIA field).

Chapter 2 Online Facilities 123

Report Decollating Mission Definition Screen

PATH Command
Command PATH can be entered on the command line of the Report Decollating
Mission Definition screen to alternately hide or display the Index Level display.
When the Index Level screen is displayed, each chain of indexes is listed when it is
defined. By default, the Index Level screen is displayed.

The following screen illustrates the definition of four index paths.

Figure 25 Report Decollating Mission Definition Screen Path Command

----- CONTROL-D/V CATEGORY CENSUS5 JOB N54COPY ---------- (R.S)
COMMAND ===> SCROLL===> CRSR
+---------------------------------------------------------------------------+
CATEGORY ACCOUNT JOBNAME CENSUS5 GENERIC MONITOR
===========================================================================
DO INDEX = STATE M R G LINE +00001 COL 00004 - 00005
MASK = @ RC Y LINE 00001 - 00001 COL 00004 - 00005
02 SUBINDX = COUNTY M LVL 02 LINE +00001 COL 00007 - 00025
MASK = RC Y LINE - COL -
03 SUBINDX = CITY M LVL 03 LINE +00001 COL 00027 - 00055
MASK = RC Y LINE - COL -
04 SUBINDX = ZIPCODE M LVL 04 LINE +00001 COL 00031 - 00040
MASK = #####-#### RC Y LINE 00001 - 00001 COL 00031 - 00040
04 SUBINDX = STREET M LVL 04 LINE +00002 COL 00004 - 00023
MASK = RC Y LINE - COL -
05 SUBINDX = BLDG_NO M LVL 05 LINE +00002 COL 00025 - 00038
MASK = RC Y LINE - COL -
06 SUBINDX = APT_NO M LVL 06 LINE +00002 COL 00032 - 00037
MASK = RC Y LINE - COL -
===========================================================================
INDEX LEVEL DISPLAY
STATE / COUNTY / CITY / ZIPCODE
STATE / COUNTY / CITY / STREET / BLDG_NO / APT_NO
===========================================================================
DO INDEX = AREACOD M R G LINE +00004 COL 00004 - 00006
MASK = ### RC Y LINE 00004 - 00004 COL 00004 - 00006
02 SUBINDX = PHONE M LVL 02 LINE +00004 COL 00008 - 00015
MASK = ###-#### RC Y LINE 00004 - 00004 COL 00008 - 00015
02 SUBINDX = FAX M LVL 03 LINE +00004 COL 00017 - 00024
MASK = ###-#### RC Y LINE 00004 - 00004 COL 00017 - 00024
SUBINDX = M LVL LINE COL -
MASK = RC LINE - COL -
===========================================================================
INDEX LEVEL DISPLAY
AREACOD / PHONE
AREACOD / FAX
===========================================================================
====== >>>>>>>>> END OF JOB/REPORT PARAMETERS FOR THIS CATEGORY <<<<<<< =====

FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 12.32.12

General Parameters
General parameters describe the mission and specify the mission type, owner and
group.

124 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Screen

Figure 26 General Parameters

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC INVENTORY AND EMPLOYEE REPORTS - DAILY
DESC
===========================================================================
DAYS

Table 28 General Parameters

Parameter Description
CATEGORY Name of the report decollating mission parameters (for example, DAILY,
MONTHLY, WORKDAY).
JOBNAME Name of the job.
GENERIC Yes/No indicator that specifies whether the mission is a regular or
generic report decollating mission.
MONITOR CONTROL-V monitor that should decollate the job.
OWNER ID of the user who requests CONTROL-V services, for security
purposes.
TASKTYPE Type of task to be performed by CONTROL-V. Currently, REP (report),
CRP (cyclic report), and ERP (emergency report) are supported.
GROUP Name of the group to which the mission belongs (for example,
BACKUPS, RESERVATIONS, INVENTORY).
JOBID JES job identification number of the job that created the report to be
decollated.
DESCH Description of the mission (free text).

Basic Scheduling Parameters

CONTROL-V Basic Scheduling parameters specify on what dates the mission is
activated. The basic scheduling requirements are then checked. If they are satisfied,
the mission is placed in the Active Missions file. However, the mission is not
activated until its runtime scheduling and message/event criteria have been satisfied.

Using the Basic Scheduling parameters is optional. The SHOW SCHEDULING

CRITERIA field of the Report Decollating Mission Definition entry panel manages the
display of Basic and Runtime Scheduling parameters on the Report Decollating
Mission Definition screen. It is also possible to control this feature from the Report
Decollating Mission Definition screen. Type SCHED (or SC) on the command line and
press Enter to alternate between display and non-display of the scheduling
parameters.

Chapter 2 Online Facilities 125

Report Decollating Mission Definition Screen

Figure 27 Basic Scheduling Parameters

===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================

Table 29 Basic Scheduling Parameters

Parameter Description
DAYS Days of the month to schedule the report decollating mission.
DCAL DAYS calendar specification.
AND/OR Conjunctional parameter that links parameters DAYS and WDAYS.
WDAYS Days of the week to schedule the report decollating mission.
WCAL WDAYS calendar specification.
MONTHS Months to activate the report decollating mission.
DATES Specific dates in the year to activate the report decollating mission.
CONFCAL Name of a calendar used to confirm report decollating mission schedule
dates.
SHIFT Indicates if and when a report decollating mission should be scheduled
when it fails confirmation by the CONFCAL calendar.
RETRO Yes/No indicator that specifies whether or not the report decollating
mission can be selected (retroactively) after the original scheduling date
has passed.
MAXWAIT Number of extra days within which to try to execute the report
decollating mission if the date of the mission has passed.
MINIMUM Minimum number of free tracks required by the library specified in
parameter PDS. The mission is scheduled if the number of free tracks is
less than the minimum.a
PDS Name of partitioned dataset to be checked for free space. The mission is
scheduled if the dataset has less than the minimum number of required
free tracks specified in parameter MINIMUM.8
a
This parameter is supported for compatibility with previous versions.

Runtime Scheduling Parameters

Runtime Scheduling parameters specify requirements that must be satisfied to
execute the mission.

126 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Screen

Figure 28 Runtime Scheduling Parameters

MINIMUM PDS
===========================================================================
IN PLRPT010-ENDED-OK ODAT
WHEN IN QUEUE Y CLS TIME FROM 0100 UNTIL 0630 INTERVAL 001 PRIORITY
DSN
===========================================================================
OUT

Table 30 Runtime Scheduling Parameters

Parameter Description
M
IN Prerequisite conditions for the report decollating mission.
WHEN IN QUEUE Indicator that specifies whether or not to look for the job in the
output queue, and whether currently executing jobs are or are not
included in the search.
CLS Any valid non-held output class. If CLS is specified, a decollating
mission does not start unless some output is currently in the
specified class.
TIME FROM/UNTIL Time limit for report decollating mission execution.
INTERVAL Minimum length of time to wait between successive executions of
cyclic report decollating missions.
PRIORITY Report decollating mission priority in receiving CONTROL-V
services.
DSN Dataset name identifiers that are common to many compressed
datasets of the job. For detailed information, see DSN: Runtime
Scheduling Parameter on page 522.

Post--Processing Parameters
Post-processing parameters specify what to do when the mission finishes processing
(OK or NOTOK).

Figure 29 Post-Processing Parameters

DSN
===========================================================================
OUT PLRPT010-DECOLLATED ODAT +
SHOUT WHEN NOTOK TO OPER2 URG R
MSG ==== REPORT DECOLLATION FOR PLRPT010 ENDED N O T O K ====
SHOUT WHEN TO URG
MSG
===========================================================================
DEF COPIES LVL USER DEST MAX COPIES

Chapter 2 Online Facilities 127

Report Decollating Mission Definition Screen

Table 31 Post-Processing Parameters

Parameter Description
OUTM Prerequisite conditions to be added and/or deleted when decollation
finishes OK.
SHOUTM Message to be sent to a specified destination in a specific situation.
WHEN Specifies the situation in which to send the message.
TO Destination of the message.
URG Urgency of message.
MSG The message (free text). CONTROL-V system variables are supported.

Decollating Parameters
Decollating parameters specify how to decollate the reports of the job.

Figure 30 Decollating Parameters

MSG
===========================================================================
DEF COPIES 01 LVL USER CRDBANK DEST MAX COPIES 05
===========================================================================
SET = %% = C CS
===========================================================================
ON CLASS = D EXTWTR DEST FORM

Default Decollating Parameters

General default decollating parameters for report pages include:

Table 32 Default Decollating Parameters

Parameter Description
DEF COPIES Default number of copies of the jobs reports to be printed.
LVL Default level of a user (recipient) who should receive every
unidentified page of the jobs reports.
USER Default name of a user (recipient) who should receive every
unidentified page of the jobs reports.
DEST Default printing destination for the jobs report pages that are not
identified in ON statements. Also used to activate extraction of
original spool destination.
MAX COPIES Maximum number of copies to be printed for the jobs reports unless
specified in an ON....MAX COPIES statement.

128 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Screen

SET Statement

The SET statement assigns an initial value to a system variable that is used during this
decollation process or a regular variable that can be used in this decollation mission.

===========================================================================
DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES 10
===========================================================================
SET = %%MEMORY =ABOVEBAR C CS
===========================================================================
ON CLASS = D EXTWTR DEST FORM

ONM Statement

The ON statement allows the decollation is to be carried out on the following criteria:

Table 33 ON Statement Subparameters

Subparameter Description
CLASS Specified class name (held and non-held).
DSN Specified compressed datasets compressed sysouts.
MQ Executes an IBM Websphere MQ message.
SYSOUT Step and/or DD statement selection criteria, for example, a program
or procedure step name, a DD name, or a class.
SYSDATA Three system datasets of the job.
SYSJCL JCL system dataset of the job.
SYSLOG Syslog system dataset of the job.
SYSMSG Execution messages system dataset of the job.
TRNCLASS Displays the same fields as the CLASS subparameters with the
addition of the CLIQUE subparameter, which identifies the Report
Clique to be used for report transformation
TRNDSN Displays the same fields as the DSN subparameter, with the addition
of the CLIQUE subparameter, which identifies the Report Clique to
be used for report transformation

ON CLASS = D EXTWTR DEST FORM

PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES 04
PRINT/CDAM PARMS =
ON SYSOUT PGMSTEP PLRPT010 PROCSTEP DDNAME PLRPT4 CLASS
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES 06
ON SYSLOG
PRT COPIES 01 LVL 90 USER PRODCNTL DEST MAX COPIES 05
PRINT/CDAM PARMS =

ON Statement Defaults

Each ON statement is followed by printing default parameters that apply to the

reports defined under the ON statement.

Chapter 2 Online Facilities 129

Report Decollating Mission Definition Screen

Table 34 ON Statement Defaults

Subparameter Description
PRT COPIES Default number of copies to print of the reports defined under the
ON statement.
LVL Default level of a user (recipient) who should receive every
unidentified page of the reports defined under the ON statement.
USER Default name of a user (recipient) who should receive every
unidentified page of the reports defined under the ON statement.
DEST Default printing destination of the unidentified pages of reports
defined under the ON statement. Also used to activate extraction of
original spool destination.
MAX COPIES Maximum number of copies that can be requested to be printed of
the reports defined under the ON statement (or in the User Report
list).
PRINT/CDAM Printing/CDAM parameters. This field overrides default CDAM
PARMS parameters, such as PREFIX and UNIT.

ON CLASS = X EXTWTR DEST FORM

PRT COPIES 01 LVL 20 USER MGT DEST RUR252 MAX COPIES
PRINT/CDAM PARMS = PAGEDEF=ARI1,FORMDEF=IBM1
PRINT/CDAM PARMS =
WHEN LINE - COL - PRINT REF NXT CT AND/OR

PRINT/CDAM Parameters

This field overrides default CDAM parameters, such as PREFIX and UNIT.

PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT Y REF NXT N CT N AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT

WHENM Parameter

The WHEN parameter indicates page identification criteria.

Table 35 WHEN Subparameters (part 1 of 2)

Subparameter Description
LINE Lines in the page (from and to) between which the character string
search takes place.
COL Columns (from and to) between which the character string search
takes place.
VAR A variable used in comparing a string, variable, or system variable in
the STRING subparameter. This subparameter is a variant of the
LINE and COL subparameters.

130 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Screen

Table 35 WHEN Subparameters (part 2 of 2)

Subparameter Description
PRINT Yes/No indicator that specifies whether or not to print the line
containing the identifying string.
REF NXT Yes/No indicator that specifies whether the identifying string refers
to the page where it is found, or to the page after the page where it is
found.
CT Continuous identification flag that indicates whether unidentified
pages are directed to the default user, to the user obtained from the
previous pages, and so on.
AND/OR Conjunctional parameter that opens and links additional WHEN
statements.
STRING The character string for that to search. The string can contain logical
comparison operators.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T

DOM Options

The following are a description and example of each of the DO action that can be
taken when the WHEN condition is fulfilled:

DO USER Name of the user (recipient) to whom the identified page in the report is
sent, or the LINE and COL range in the report where the user name can be found.

DO USER = * LVL LINE COL 00064 - 00074

S N T SYNONYM = CONCAT = _

DO INDEX Defines a main index and optional subindexes for a CDAM file.

DO INDEX = EMNUM M R G LINE +00000 COL 00011 - 00014

MASK = #### RC Y LINE 00002 - 00060 COL 00011 - 00014
02 SUBINDX = EMPNAME M LVL 02 LINE +00000 COL 00016 - 00035
MASK = * RC Y LINE 00002 - 00060 COL 00016 - 00035
03 SUBINDX = EMPGRADE M LVL 03 LINE +00000 COL 00037 - 00040
MASK = #### RC Y LINE 00002 - 00060 COL 00037 - 00040
SUBINDX = M LVL LINE COL -
MASK = RC LINE - COL -

DO MIGRATE Specifies the migration mission that migrates this report from
DASD to another storage media.

DO MIGRATE = MIG0007Y
DO

Chapter 2 Online Facilities 131

Report Decollating Mission Definition Screen

DO BACKUP Specifies the backup missions that backs up this sysout.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR

DO PRINT Specifies the printing missions that should (can) print this report.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO PRINT = STD MUST
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR

DO NAME Specifies the report name. The user (recipient) can use the name as a
key for retrieving the report.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR

DO COND Adds and/or deletes prerequisite conditions.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO COND = EMPLOYEES-FILE-OK ODAT +
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR

DO SET Assigns a value to a variable that can be used by other decollation

parameters.

WHEN LINE 00001 - 00001 COL 00001 - 00001 PRINT REF NXT CT AND/OR
STRING = %%ACC
DO
DO SET = %%REP ='REPORT FOR ' C CS
DO SET = %%REM_M =NEW C CS

DO SHOUT Specifies a message to be sent. CONTROL-V system variables are

resolved in the message text.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO SHOUT TO U-EMPLOYEES-DEP URGENCY R
= MONTHLY EMPLOYEES FILE AND REPORTS ARE OK
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR

132 CONTROL-D and CONTROL-V User Guide

 Editing Mission Definitions in the Edit Environment

DO CTBRULE Invokes the CONTROL-M/Analyzer Runtime Environment that

performs balancing operations defined in the specified rule on CONTROL-V pages.
Available only at sites using CONTROL-M/Analyzer.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = B A N K I N G R E P O R T
DO CTBRULE = BNKRULE ARG 100000,50000,25000
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO

DO NOTOK Generates a NOTOK status if the string specified in the WHEN

statement is found.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = ENDED WITH ERRORS
DO NOTOK
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR

DO REMARK Specifies a remark to be generated when the string specified in the

WHEN statement is found.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E X C E P T I O N S R E P O R T
DO REMARK = EXCEPTION LINE COL -
DO REMARK2 = EXCEPTION LINE COL -
DO REMARK3 = EXCEPTION LINE COL -

DO LEVEL Specifies the level of the user (recipient) to whom the identified page in
the report is sent. It is recommended not to use DO LEVEL at this stage.

WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E X C E P T I O N S R E P O R T
DO LEVEL
WHEN LINE - COL - PRINT REF NXT CT AND/OR

Editing Mission Definitions in the Edit Environment

Report decollating mission definition parameters can be edited (moved, copied,
deleted, repeated) by performing IOA line editing commands, similar to standard
ISPF line commands, from within the CONTROL-V Edit environment.

The EDIT command alternately activates and deactivates the Edit environment of the
Report Decollating Mission Definition screen.

Chapter 2 Online Facilities 133

Exiting the Report Decollating Mission Definition Screen

Figure 31 Entering Editing Commands

------- CONTROL-D/V CATEGORY DAILY JOB * ---------(R.S)
COMMAND ===> SCROLL===> CRSR
+---------------------------------------------------------------------------+
__ WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
__ STRING =
__ DO NAME = PRODUCTION JCL
MM DO USER = * LVL LINE COL 00064 - 00074
S N T SYNONYM = CONCAT =
__ DO BACKUP = BKP0007D
__ DO SHOUT TO TSO-001 URGENCY
MM = NON-PRODUCTION JCL COMPLETED
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO
__ =========================================================================
__ ON CLASS = B EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
__ PRINT/CDAM PARMS =
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
A_ DO NAME = NON-PRODUCTION JCL
__ DO
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 18.47.45

A 2-character line editing command field, marked by underscores, is displayed for

each line on the screen.

Editing commands are typed directly onto these underscores.

Specified line editing commands are processed when Enter is pressed.

For more detailed information and examples, see Appendix A, Editing Mission
Definitions in the IOA Edit Environment..

Exiting the Report Decollating Mission Definition Screen

Use one of the following commands to exit the Report Decollating Mission Definition
screen:

Table 36 Commands for Exiting the Report Decollating Mission

Definition Screen (part 1 of 2)
Command Description
END Keep the changes made to the parameters of the mission and return to
the Category List screen.
CANCEL Do not keep the changes made to the parameters of the mission and
return to the Category List screen.

134 CONTROL-D and CONTROL-V User Guide

 Exiting the Report Decollating Mission Definition Screen

Table 36 Commands for Exiting the Report Decollating Mission

Definition Screen (part 2 of 2)
Command Description
NEXTCTG Keep the changes made to the parameters of the mission and display the
next mission definition in the Category list.
PREVCTG Keep the changes made to the parameters of mission and display the
previous mission definition in the Category list.

NOTE
Changes made to the parameters are initially kept only in memory. They are written to the
disk after you exit the Category List screen.

Automatic Syntax Checking

The definition syntax is automatically checked when the Report Decollating Mission
Definition screen is exited using the END, NEXTCTG, or PREVCTG command. This
includes checking that users specified in DO USER statements are in the Recipient
Tree.

If errors are found in the Report Decollating Mission Definition screen an error
message is displayed. The errors may then be corrected. If no errors are found, exit to
the Category List screen.

CHKUSR Command
The CONTROL-D CHKUSR command checks if the user specified in parameter DO
USER is found in the Recipient Tree. Type CHKUSR (or CH) on the COMMAND line
and press Enter.

NOTE
This check is performed automatically when exiting the Report Decollating Mission Definition
screen.

Saving Report Decollating Mission Definitions

Press END (PF03/PF15) to exit the Category List screen. If changes have been made
in the Report Decollating Mission Definition facility, an Exit Option window is
opened.

Chapter 2 Online Facilities 135

Ordering Report Decollating Missions

Figure 32 The Report Decollating Mission Definition Exit Option Window

CATEGORIES OF LIB CTD.PROD.REPORTS JOB: PLRPT010
COMMAN +-----------------------------------------------------------+ ===> CRSR
OPT N | PLEASE SELECT EXIT OPTION | ---------
D | |
M | SAVE CREATE |
===== | | <<< =====
| LIBRARY CTD.PROD.REPORTS |
| JOB PLRPT010 |
| |
+-----------------------------------------------------------+

OPTIONS: S SELECT D DELETE I INSERT O ORDER F FORCE C COPY 15.10.46

You must enter Y (Yes) or N (No) in one of the exit options. It is possible to change the
name of the library or member (job or report name) in the window. Return to the Job
List or to the entry panel, depending on where you were when you entered the
Category List screen.

When saving changes using the EXIT option, all of the mission definitions within a
member (job) are saved, even if changes were made to only one mission definition.

Canceling Changes
To exit without saving decollating parameter changes, enter the CANCEL command
in the Mission Definition screen, or press RESET (PF04/PF16) in the Exit Option
window of the Category List screen

Ordering Report Decollating Missions

The Report Decollating Mission Definition screen is used to define decollating and
indexing criteria. This definition becomes active only after it is ordered. The report
decollating mission can be ordered manually, or it can be ordered automatically each
day. For further information see the CONTROL-D and CONTROL-V chapter of the
INCONTROL for z/OS Administrator Guide. One way to manually order missions is to
use options O and F of the Job or Category List screens.

136 CONTROL-D and CONTROL-V User Guide

 Ordering Report Decollating Missions

The options can be activated from:

Job List screen All report decollating mission definitions in the selected jobs are
ordered.
Category List screen Only the selected decollating mission definition is ordered.

These options are specified as follows:

Table 37 Options for Ordering Report Decollating Missions

Option Description
O (ORDER) Schedule the report decollating mission only if the specified date is defined
as a scheduling date in the mission definitions basic scheduling criteria.
F (FORCE) Schedule the report decollating mission regardless of basic scheduling
criteria.

When you use the O and F options, the default confirmation window shown below is
opened. If the default has been modified in the User profile, a different confirmation
window, requiring double confirmation, is opened:

Figure 33 Order and Force Confirmation Window

LIST OF JOBS LIB: CTD.PROD.REPORTS ----------------
COMMAND ===> SCROLL===> CRSR
OPT NAME ------------ VV.MM CREATED CHANGED SIZE INIT MOD ID
ACCTNG01 01.00 00/08/08 00/08/08 16:54 18 18 0 M04B
ACCTNG02 01.00 00/08/08 00/08/08 16:54 20 20 0 M04B
ACCTNGW1 +-------------------------------+ 9 0 M35A
ACCTNGW2 | CONFIRM ODATE 000808 |
O ACCTNGW3 <-----------| ASK FOR EACH ONE Y |
ACCTNGW4 +-------------------------------+ 8 0 m18C
ADMINST1 01.00 00/04/17 00/04/17 00:50 70 70 0 O01
ADMINST2 01.00 00/04/17 00/04/17 00:50 180 180 0 O01
PERSNL10 01.00 00/04/17 00/04/17 00:50 41 41 0 O01
O PERSNLDK 01.00 00/04/17 00/04/17 00:50 5 5 0 S07
PERSNLST 01.00 00/04/17 00/04/17 00:50 9 9 0 S07
PRODTNCL 01.00 00/04/17 00/04/17 00:50 14 14 0 S07
PRODTNTL 01.00 00/04/17 00/04/17 00:50 5 5 0 S07
O RESTOR01 01.01 00/09/25 00/09/25 12:17 9 9 0 M35A
RESTOR02 01.00 00/06/30 00/06/30 09:54 12 12 0 V309
SALESD 01.02 00/09/22 00/09/22 11:04 8 6 0 M72
SALEST 01.01 00/09/26 00/09/26 13:33 8 8 0 M18C
SALESV 01.00 00/04/17 00/04/17 00:50 70 70 0 O01
TRAIN001 01.00 00/08/08 00/08/08 16:54 18 18 0 M04B
TRAIN002 01.00 00/08/08 00/08/08 16:54 20 20 0 M04B
OPTIONS: S SELECT O ORDER F FORCE B BROWSE D DELETE 14.39.49

The specified date can be changed. If you decide not to order the member (job) or
mission definition (category), enter N (No) in the CONFIRM field (for CANCEL), and
you return to the original screen.

Chapter 2 Online Facilities 137

Copying Report Decollating Mission Definitions to Another Member

The ASK FOR EACH ONE line is only displayed if more than one Order (or Force) is
requested. If you are certain that you want to order or force all indicated members
(jobs) or mission definitions (categories), and do not want to change the ODATE for
any of the individual members or mission definitions, you can bypass individual
confirmations by entering Y (Yes) in the CONFIRM field and N in the ASK FOR EACH
ONE field, and pressing Enter. All the members or mission definitions marked O (or
F) is ordered.

For each member or mission definition that is successfully scheduled (ordered), the
screen in Figure 34 appears.

Figure 34 The CONTROL Report Order Message Screen

---------------------- CONTROL-D REPORT ORDER MESSAGES ------------------(R.O)
COMMAND ===> SCROLL===> CRSR
------------------------------------------------------------------------------
17.24.36 CTD049I MISSION PROCESSING STARTED
17.24.39 CTD528I MISSION PRDKPLW4 ODATE 080800 PLACED ON ACTIVE MISSIONS FILE
17.24.39 CTD696I ALL MISSIONS PROCESSED SUCCESSFULLY
===== >>>>>>>>>>>>>>>>>>>> END OF MESSAGE LIST <<<<<<<<<<<<<<<<<<<<< =====

PRESS END TO RETURN. LEFT AND RIGHT TO SEE MORE. 09.18.06

Use the END command (PF03/PF15) to return to the Job or Category List screen.

Copying Report Decollating Mission Definitions to Another

Member
To copy one or more mission definitions from the current member to another
member, specify option C (Copy) by the mission names in the Category List screen
and press Enter. The following window is displayed:

138 CONTROL-D and CONTROL-V User Guide

 Copying Report Decollating Mission Definitions to Another Member

Figure 35 Window for Copying Decollating Mission Definitions to Another Member

CATEGORIES OF LIB CTV.PROD.REPORTS JOB: PLRPT010
COMMAND ===> SCROLL===> CRSR
OPT NAME -------------------------------------------------------------------
C DAILY INVENTORY AND EMPLOYEE REPORTS - DAILY
MONTHLY INVENTORY AND EMPLOYEE REPORTS - MONTHLY

+-----------------------------------------------------------+
| |
| SPECIFY DESTINATION LIBRARY,MEMBER AND CATEGORY NAME |
| |
| LIBRARY : CTV.PROD.REPORTS |
| MEMBER : |
| CATEGORY: DAILY |
| |
| PRESS END/RESET TO CANCEL ENTER TO PERFORM THE COPY |
+-----------------------------------------------------------+

The window contains the following fields (some fields contain default values that can
be modified):

Table 38 Fields in the Window for Copying Mission Definitions to

Another Member
Field Description
Library Library containing the table into which the decollating mission definitions
should be copied. Must be an existing library. Default is the current
library.
Member Name of the member into which the decollating mission definition should
be copied.
Note: A decollating mission definition can only be copied to another
member. It cannot be copied to its own member (even if the mission
definition is renamed).

If the specified member does not exist, the member is created when the
request is performed.
Category Name of the decollating mission definition to be copied. If multiple
mission definitions are selected, the window initially is displayed with the
first selected mission definition. As each request is performed or canceled,
the next requested mission definition name is displayed.

To perform a request, press Enter.

To cancel a request, press END (PF03/PF15) or RESET (PF04/PF16).

Chapter 2 Online Facilities 139

Migration, Printing, Backup, Restore Mission Definition Facility

Migration, Printing, Backup, Restore Mission

Definition Facility
The CONTROL-V Migration, Printing, Backup, Restore Mission Definition facility is
composed of a series of screens which enable you to view, create, and modify
printing, backup and restore mission parameters.

Migration, printing, backup, and restore mission definitions under CONTROL-V are
stored in libraries (partitioned datasets). A library contains missions (members), and
each mission contains categories of one or more mission definitions. A mission
generally contains migration, printing, backup, and restore mission categories related
to specific topics. Although most sites designate a primary mission library, the
number of mission libraries that you can use is unlimited.

NOTE
Missions contain mission definitions not the JCL of the mission.

The number of missions in a library, the number of mission definitions in a mission,

and the size of each mission definition are all calculated dynamically and are not
dependent on parameter specification or optional ZAPs.

Accessing the Migration, Printing, Backup, Restore Mission

Definition Facility
The Migration, Printing, Backup, Restore Mission Definition facility contains the
following screens:

Table 39 Printing, Backup, Restore Mission Definition Facility Screens

Screen Description
Mission Definition Allows specification of parameters which determine which screen is
entry panel displayed.
Mission List screen Displays the list of missions (members) in the specified library.
Category List screen Displays the list of categories of mission definitions in a specific
mission table.
Mission Definition Displays the parameters of the selected mission definition. This
screen screen is used to define, display and modify mission definition
parameters.

To create mission definitions via the online facility, select option M on the IOA
Primary Option menu. The Mission Definition entry panel is displayed.

140 CONTROL-D and CONTROL-V User Guide

 Creating Missions

Creating Missions
Missions can be created in any of the following ways:

By specifying the new mission name in the entry panel and pressing Enter.

By using the SELECT command (described later) to specify the new mission name
in the Mission List screen and pressing Enter.

As a result of using either of the above methods, a skeletal mission definition (that
is, one with most fields left blank) is displayed in the Mission Definition screen.

Fill in the blanks and save the screen entries. The mission is created with the specified
mission definition. The mission definition is the first and only definition in the
Category list for the mission. As additional mission definitions are created in the
mission (described below), they are added to the Category list.

NOTE
Upon exiting the Category List screen, if changes were made in at least one mission definition,
an Exit Option window is displayed. One field of the window displays the mission name. This
value can be changed to a new mission name that creates a new mission in which the mission
definitions are saved.

Creating Mission Definitions

Mission definitions can be created using two basic methods:

A skeletal mission definition can be created by specifying the name of a new

mission definition (category) in the entry panel. (The mission specified in the entry
panel can be either a new mission or an existing mission.) In this case, virtually all
fields of the mission definition are empty.

A copy of an existing mission definition can be created using the INSERT option
(described later) in the Category List screen. In this case, most fields of the new
mission definition have the same values as the fields in the copied mission
definition.

Performing Operations on Missions and Mission Definitions

Many operations can be performed on missions and on the mission definitions in
them. These operations are performed using commands and options in the various
screens of the Migration, Printing, Backup, Restore Mission Definition facility.

Chapter 2 Online Facilities 141

Performing Operations on Missions and Mission Definitions

Below is a brief summary of some of the major operations possible within the facility.
Additional options and commands that have not yet been explained are explained in
detail following the summary.

Accessing (Editing or Browsing) a Mission and its Mission

Definitions
A mission (that is, the mission definitions in the mission) can be browsed or edited.

When browsed, the mission cannot be modified or updated. When the mission is
edited, new mission definitions can be added and existing mission definitions can be
modified or deleted.

Browsing, however, has advantages:

Access and exit are quicker than in editing.

Mission definitions that are in use by another user can be viewed.
Access for browsing might be granted, even though access for editing might be
denied due to site security requirements.

To browse a mission (and its category list and mission definitions), use the BROWSE
option in the Mission List screen.

Entering the mission name in the entry panel or using the SELECT option in the
Mission List screen provides edit access.

Depending on user profile definitions, if the table requested for editing is in use,
either access is granted in Browse mode or access is not granted.

Copying a Mission Definition to Another Mission

Mission definitions can be copied from one mission to another using the COPY
option in the Category List screen. For more information, see Copying Migration,
Printing, Backup, Restore Mission Definitions to Another Member on page 169.

Deleting a Mission or a Mission Definition

Unneeded mission definitions can be deleted using the DELETE option in the
Category List screen. For more information, see Options of the Category List Screen
on page 119. Unneeded missions can be deleted using the DELETE option in the
Mission List screen. For more information, see Deleting Missions on page 148.

142 CONTROL-D and CONTROL-V User Guide

 Entry Panel

Ordering Multiple Missions

More than one mission at a time can be ordered at one time. To select multiple
missions, Tab down to each mission in the Missions List screen that you want to select
and enter the letter O next to the desired mission. Press Enter. A popup
confirmation window is displayed, prompting you to choose whether or not to view
the confirmation window for each mission.

If you choose not to view the confirmation screen before viewing each mission
(Confirm Y, Ask For Each One N), press Enter.

Saving Modifications
All changes made to a mission and its mission definitions are kept in memory until
the mission is exited. Upon exiting the mission, the user can choose to save or cancel
the changes. For more information, see Exiting the Mission Definition Screen on
page 166.

Entry Panel
Figure 36 Printing, Backup, Restore Mission Definition Facility Entry Panel
--------------- CONTROL-D/V MISSION DEFINITION - ENTRY PANEL --------------(M)
COMMAND ===>

SPECIFY LIBRARY, MISSION NAME, CATEGORY

LIBRARY ===> CTV.PROD.MIGMIS

MISSION ===> TYPE ==> (PRT, BKP, RST, MIG)
CATEGORY ===>

FOR A NEW MISSION, SPECIFY THE MISSION TYPE 13.00.49

Chapter 2 Online Facilities 143

Entry Panel

NOTE
If you use the selection list fields, their values are not erased until you exit the entry panel by
pressing END (PF03/PF15).

To open the desired display fill in Entry Panel fields LIBRARY, MISSION, and
CATEGORY, as described below.

To display the list of missions in a library

1 Type the library name.

2 Leave the mission name blank or type the mission name using mask characters (*
and ?).

3 Press Enter.

To display the list of mission definitions of a specific mission

1 Type the library name.

2 Type the mission name.

3 Press Enter.

If the mission does not exist, the screen for defining a new mission in the mission is
displayed.

To display the details of a specific mission definition (Mission Definition

screen)

1 Type the library name.

2 Type the mission name.

3 Type the mission definition (category) name.

4 Press Enter.

If the mission does not exist, or the mission definition for the specified mission does
not exist, the screen for defining a new mission in the mission is displayed.

144 CONTROL-D and CONTROL-V User Guide

 Entry Panel

NOTE
If you enter the screen for defining a new mission definition and want to leave the screen
without defining a mission definition, use the CANCEL command.

To display the Search Window

1 Type the library name.

2 Type the mission definition (category) name.

3 Leave the mission name blank or type the member name using mask characters (*
and ?).

4 Press Enter.

To create a new mission

1 Type the library name.

2 Specify a new mission name.

3 Press Enter.

The Mission Definition screen, for defining the first mission in the new mission, is
displayed.

Search Window
The Search window allows the user to search for the specified mission definition in
members of the specified library. Members in which the mission definition have been
found are then displayed in the Mission List screen.

Chapter 2 Online Facilities 145

Entry Panel

Figure 37 Printing, Backup, Restore Mission Definition Facility Search Window

------------- CONTROL-D/V MISSION DEFINITION - ENTRY PANEL -----------------(M)
COMMAND ===>
SPECIFY LIBRARY, MISSION NAME, CATEGORY
LIBRARY ===> CTD.PROD.BKPMIS
MISSION ===> (Blank for mission selection list)
CATEGORY ===> CTDSAMPLE (Blank for category selection list)
+-------------------------------------------+
| |
| PLEASE SELECT ONE OF THE FOLLOWING: |
| |
| 1 - STOP SEARCH IMMEDIATELY |
| 2 - ASK AGAIN AFTER 000010 MEMBERS |
| 3 - UNCONDITIONAL SEARCH |
| |
| NUMBER OF MEMBERS IN LIBRARY: 000015 |
| NUMBER OF SEARCHED MEMBERS: 000000 |
| NUMBER OF SELECTED MEMBERS: 000000 |
| |
+-------------------------------------------+

USE THE COMMAND SHPF TO SEE PFK ASSIGNMENT 12.11.54

To close the Search Window without performing any action, press END (PF03/PF15).

To perform a search, select one of the following choices and press Enter:

3 - UNCONDITIONAL SEARCH

Performs an uninterrupted search of all members (missions) in the specified

library.

The search is stopped immediately when you select option 1.

2 - ASK AGAIN AFTER number MEMBERS

Searches the specified number of members in the specified library, and then
pauses. The search number can be modified. Default:10.

Continue the search by pressing Enter.

Stop the search by selecting option 1 (Stop Search Immediately).

If any members are found, the Mission List is displayed listing those members.

During the search, the following information is displayed at the bottom of the
window:

146 CONTROL-D and CONTROL-V User Guide

 Migration, Printing, Backup, Restore Mission Definition Mission List Screen

Number of members in library. Lists the total number of members in the specified
library.

Number of searched members. Lists the cumulative number of members searched.

For example, if you perform three searches with a specified number of 10, the
figure displayed is 30.

Number of selected members. Lists the cumulative number of members selected

that contain the mission definition being searched.

If any members are selected during the search, the Mission List is displayed listing
those members. If no members are selected, the Search Window is closed and a
message is displayed.

Migration, Printing, Backup, Restore Mission Definition

Mission List Screen
This screen displays a list of missions (members) in the specified library. This screen
can be entered directly from the entry panel or upon exiting the Category List screen.

By default, only mission names are listed on the screen. However, if the default has
been modified at your site, statistical information may be displayed for each mission
name (as shown in Figure 38).

Figure 38 Printing, Backup, Restore Mission Definition Mission List Screen

MISSION LIST IN CTD.PROD.MIGMIS ---------(M)
COMMAND ===> SCROLL ===> CRSR
OPT NAME ------------ VV.MM CREATED CHANGED SIZE INIT MOD ID
MIG0009D 01.01 00/11/29 00/11/29 12:40 15 15 0 PROD
MIG0027D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
MIG0196D 01.01 00/06/30 00/06/30 09:54 15 15 0 PROD
MIG0200D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
MIG0206D 01.01 00/11/29 00/11/29 12:40 15 15 0 PROD
MIG0222D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
MIG0257D 01.01 00/11/29 00/11/29 12:40 15 15 0 PROD
MIG0271D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
MIG0280D 01.01 00/11/29 00/11/29 12:40 15 15 0 PROD
MIG0297D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
MIG0332D 01.01 00/11/29 00/11/29 12:40 15 15 0 PROD
MIG0356D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
====== >>>>>>>>>>>>>>>> NO MORE MISSIONS IN LIBRARY <<<<<<<<<<<<<<<< =======

OPTIONS: S SELECT O ORDER F FORCE B BROWSE D DELETE 15.24.57

Chapter 2 Online Facilities 147

Migration, Printing, Backup, Restore Mission Definition Mission List Screen

To scroll down the Mission list, press PF08/PF20. To scroll up the Mission list, press
PF07/PF19. To return to the entry panel, press END (PF03/PF15).

Options of the Mission List Screen

To request one of the following options, specify the option in the OPT field to the left
of the mission names and press Enter.

Table 40 Options of the Mission List Screen

Option Description
S (SELECT) Display the list of mission definitions of the mission for any purpose,
including editing and modification. Only one mission can be selected at
a time.
O (ORDER) Order all the mission definitions of the mission, provided that their basic
scheduling criteria (discussed in Basic Scheduling Parameters on
page 125) are met. Multiple missions can be ordered.
F (FORCE) Order all the mission definitions of the mission, regardless of their basic
scheduling criteria (discussed in Basic Scheduling Parameters on
page 125). Multiple missions can be forced.
B (BROWSE) Display a list of mission definitions of a mission for browsing. Only one
mission can be browsed at a time.
D (DELETE) Delete the mission (member) from the library. Multiple missions can be
deleted.

NOTE
The INCONTROL administrator can authorize specific users to access only the Browse option.

Deleting Missions
To delete missions, specify option D in the OPT field to the left of the missions to be
deleted and press Enter.

The following confirmation window is displayed, in sequence, for each mission

selected for deletion.

148 CONTROL-D and CONTROL-V User Guide

 Migration, Printing, Backup, Restore Mission Definition Category List Screen

Figure 39 Migration, Printing, Backup, Restore Mission Definition Facility

Delete Confirmation Window
MISSION LIST IN CTD.PROD.BKPMIS ---------(M)
COMMAND ===> SCROLL ===> CRSR
OPT NAME ------------ VV.MM CREATED CHANGED SIZE INIT MOD ID
BKP0009D 01.01 00/11/29 00/11/29 12:40 15 15 0 PROD
BKP0027D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
BKP0196D +--------------------------+
BKP0200D | CONFIRM DELETE OPTION |
D BKP0206D <-----------| (Y/N) | 5 15 0 PROD
BKP0222D +--------------------------+ 7 7 0 PROD
D BKP0257D 01.01 00/11/29 00/11/29 12:40 15 15 0 PROD
BKP0271D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
BKP0280D 01.01 00/11/29 00/11/29 12:40 15 15 0 PROD
D BKP0297D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
BKP0332D 01.01 00/11/29 00/11/29 12:40 15 15 0 PROD
BKP0356D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
====== >>>>>>>>>>>>>>>> NO MORE MISSIONS IN LIBRARY <<<<<<<<<<<<<<<< =======

OPTIONS: S SELECT O ORDER F FORCE B BROWSE D DELETE 15.24.57

Enter Y (Yes) in the window to confirm the delete request.

Enter N (No) in the window to cancel the delete request.

NOTE
If PDSMAN is operational at your site, $$$SPACE missions are not deleted.

A message is written to the IOA Log file for each mission deleted.

Migration, Printing, Backup, Restore Mission Definition

Category List Screen
This screen displays the list of mission definitions in a mission in a specified library.
This screen can be entered directly from the Migration, Printing, Backup, Restore
Mission Definition entry panel or the Mission List screen, or upon exiting the Mission
Definition screen.

Chapter 2 Online Facilities 149

Migration, Printing, Backup, Restore Mission Definition Category List Screen

NOTE
If the S (Select) option was specified in the Mission List screen for a mission that is currently in
use (selected) by another user, then either the Category List screen is not displayed and the
Mission List screen remains displayed (the default), or the Category List screen is displayed in
Browse mode (if a User profile definition overrides the default). In either case, an appropriate
message is displayed.

Figure 40 Migration, Printing, Backup, Restore Mission Definition

Category List Screen

CATEGORIES OF LIB CTD.PROD.PRTMIS PRT MIS STD

COMMAND ===> SCROLL ===> CRSR
OPT NAME --------------------------------------------------------------------
NORTH-COURIER BUNDLE FOR COURIER TO NORTH BRANCHES
SOUTH-COURIER BUNDLE FOR COURIER TO SOUTH BRANCHES
CENTRAL-COURIER BUNDLE FOR COURIER TO CENTRAL BRANCHES
====== >>>>>>>>>>>>>> NO MORE CATEGORIES IN THE MISSION <<<<<<<<<<<<<<< =====

OPTIONS: S SELECT D DELETE I INSERT O ORDER F FORCE C COPY 10.16.49

Use the scrolling conventions to scroll forward and backward through the Category
list.

Format of the Category List Screen

Next to each mission definition name in the Category list, certain information can be
displayed. The type and format of this information depends on whether the screen is
displayed in DESC format or in STAT format:

In DESC format, the mission definitions description, taken from the DESC field of
the mission definition, is displayed. Default.

In STAT format, the mission definitions ISPF statistical information is displayed.

By default, the Category list is displayed in DESC format. To change formats, use the
DESC or STAT commands, described below.

150 CONTROL-D and CONTROL-V User Guide

 Migration, Printing, Backup, Restore Mission Definition Category List Screen

Commands of the Category List Screen

The following commands can be specified in the COMMAND field of the Category
List screen.

Table 41 Commands of the Category List Screen

Command Description
DESC Command DESC displays the mission definitions description next to
the mission definition name. The description is taken from the DESC
field in the mission definition.
STAT Command STAT displays the following ISPF like statistical
information about the mission definition next to the mission
definition name. Version and modification numbers, creation date,
last modification date, and user ID.

Options of the Category List Screen

To request one of the following options, specify the option in the OPT field to the left
of the mission definition name and press Enter.

NOTE
If the Category List screen is displayed in Browse mode, options D (Delete) and I (Insert) are
not available.

Table 42 Options of the Category List Screen (part 1 of 2)

Option Description
S (SELECT) Display the Mission Definition screen, which contains mission
parameters of the specific mission definition.

If the Mission Definition screen is not displayed in Browse mode, the

mission parameters can be edited and updated. If the Mission Definition
screen is displayed in Browse mode, the mission parameters can only be
browsed; they cannot be modified.
D (DELETE) Delete a mission definition from the Category list.
I (INSERT) Insert a new mission definition in the list. The Mission Definition screen
appears, with the same details of the mission definition marked I, but
the CATEGORY and DESCRIPTION parameters are empty for you to fill
in. The new mission definition is added after the mission definition
marked I.
O (ORDER) Order a mission definition of a mission based on its basic scheduling
criteria. For more information, see Basic Scheduling Parameters on
page 125.

Chapter 2 Online Facilities 151

Migration, Printing, Backup, Restore Mission Definition Screen

Table 42 Options of the Category List Screen (part 2 of 2)

Option Description
F (FORCE) Force a mission definition order regardless of its basic scheduling
criteria. For more information, see Basic Scheduling Parameters on
page 125.
C (COPY) Copy the mission definition to another mission (described in Copying
Report Decollating Mission Definitions to Another Member on
page 138). Multiple mission definitions can be copied.

Migration, Printing, Backup, Restore Mission Definition

Screen
This screen is used to define, display, and modify mission parameters of a specific
mission definition. The screen can be entered directly from the Migration, Printing,
Backup, Restore Mission Definition entry panel, or from the Category List screen.
Update of parameters is not permitted in Browse mode.

Mission parameters can take up more than one screen. Use the scrolling conventions
to scroll the mission parameters forward and backward.

For a detailed explanation of migration, printing, backup and restore mission

parameters, see Chapter 4, Migration, Printing, Backup and Restore Mission
Parameters.

NOTE
Parameters marked with the symbol M can have many occurrences. Whenever you fill the last
occurrence of the parameter on the screen, CONTROL-V adds a new empty occurrence of that
parameter that you may fill in. The only limit to the number of occurrences is the region size
available for the application.

To delete a parameter on the screen, simply erase it (press the EOF key or blank it
out). If additional operations are required, CONTROL-V issues appropriate
instructions.

Migration, printing, backup and restore mission parameters are divided into six basic
groups, as indicated on the following screen:

1. General parameters

2. Bundling parameters (printing missions only)

3. Basic Scheduling parameters

4. Runtime Scheduling parameters

152 CONTROL-D and CONTROL-V User Guide

 Migration, Printing, Backup, Restore Mission Definition Screen

5. Post-processing parameters

6. Mission specific parameters (printing, migration and backup missions only)

The groups are separated by a delimiter line.

Display or Non-Display of Scheduling Criteria

All of the General, Basic Scheduling, Runtime Scheduling and Post-processing
parameters are displayed in the Mission Definition screens.

SCHED Command
Typing SCHED (abbreviated SC) in the command line alternately hides or displays
the scheduling parameters in the Mission Definition screen.

Chapter 2 Online Facilities 153

Migration, Printing, Backup, Restore Mission Definition Screen

Migration Mission Definition Screen

Figure 41 Migration Mission Definition Screen
---- CONTROL-V CATEGORY MIGSEC MIG MISSION MIGSEC --------(M.S)
COMMAND ===> SCROLL===> CRSR
+---------------------------------------------------------------------------+
======= >>>>>>>>>>>>>>>>>>> TOP OF CATEGORY PARAMETERS <<<<<<<<<<<<<<<< =====
CATEGORY MIGCAT MISSION MIGSEC
OWNER M15A TASKTYPE MIG GROUP
DESC
===========================================================================
STAGE 01 SCHEDULING PARAMETERS
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN IN-CARD ODAT IN-CARD2 ODAT
IN
TIME FROM 0010 TO 1200 NOT LATER THAN 1258 PRIORITY 09
===========================================================================
OUT OUT-CARD ODAT +
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG MIGRATION MISSION MIGSEC STAGE 01 ENDED NOTOK
===========================================================================
RETENTION DAYS 00370 FORCE N SECONDARY SKELETON MICSEC
CENTERA RETENTION CLASS
===========================================================================
STAGE 01 PRIMARY MEDIA NAME CART AGE 0001 REFRESH EVERY
SECONDARY MEDIA NAME REFRESH EVERY
===========================================================================
MIGRATION PATH SCHEDULING PARAMETERS
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN MSM-IN ODAT
TIME FROM 1030 TO 1322 NOT LATER THAN 1458 PRIORITY 09
===========================================================================
OUT MSMOUT ODAT +
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG MIGRATION MISSION MIGSEC STAGE 02 ENDED NOTOK
===========================================================================
STAGE 02 PRIMARY MEDIA NAME FTK1 AGE 0003 REFRESH EVERY
FSET VSET
SECONDARY MEDIA NAME REFRESH EVERY
STAGE 03 PRIMARY MEDIA NAME AGE REFRESH EVERY
SECONDARY MEDIA NAME REFRESH EVERY
===========================================================================
====== >>>>>> END OF MIGRATE MISSION PARAMETERS OF THIS CATEGORY <<<<<< =====

PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 12.12.05

154 CONTROL-D and CONTROL-V User Guide

 Migration, Printing, Backup, Restore Mission Definition Screen

Printing Mission Definition Screen

Figure 42 Printing Mission Definition Screen
---- CONTROL-V CATEGORY NORTH-COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+---------------------------------------------------------------------------+
CATEGORY NORTH-COURIER MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP DAILY-PRT
BATCH SKELETON FREE CLOSE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION TEST
DESC BUNDLE FOR COURIER TO NORTH BRANCHES
===========================================================================
INCLUDE USER NORTH
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 6,3,8
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
TIME FROM 0230 TO NOT LATER THAN 0300 PRIORITY 10
ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER3 URGN R
MSG PRINTING MISSION STD ENDED NOTOK
PRINTER PRT1 DEST CHUNKSIZE
PRINTER DEST CHUNKSIZE
ON FORM
REQUEST
===========================================================================
STORE BACKUP MIGRATION
====== >>>>>> END OF PRINTING MISSION PARAMETERS OF THIS CATEGORY <<<<<< ====
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 09.08.12

Chapter 2 Online Facilities 155

Migration, Printing, Backup, Restore Mission Definition Screen

Backup Mission Definition Screen

Figure 43 Backup Mission Definition Screen
---- CONTROL-V CATEGORY DAILY BKP MISSION BKP0031D --------(M.S)
COMMAND ===> SCROLL===> CRSR
+----------------------------------------------------------------------------+
CATEGORY DAILY MISSION BKP0031D
OWNER M22 TASKTYPE BKP GROUP DAILY-BKP
DESC BACKUP REPORTS FOR 31 DAYS
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN OP-START-BACKUP-031D ODAT
TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
# OF DAYS TO KEEP 00031 # OF GENERATIONS TO KEEP 0000
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG BACKUP MISSION BKP0031D ENDED NOTOK
SHOUT WHEN TO URGN
MSG
====== >>>>>>> END OF BACKUP MISSION PARAMETERS OF THIS CATEGORY <<<<<< ======
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 10.21.10

156 CONTROL-D and CONTROL-V User Guide

 Migration, Printing, Backup, Restore Mission Definition Screen

Restore Mission Definition Screen

Figure 44 Restore Mission Definition Screen
---- CONTROL-V CATEGORY DAILY RST MISSION RSTADHOC --------(M.S)
COMMAND ===> SCROLL===> CRSR
+----------------------------------------------------------------------------+
CATEGORY DAILY MISSION RSTADHOC
OWNER M22 TASKTYPE RST GROUP DAILY-RST
DESC AD-HOC RESTORE MISSION
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN OP-START-RESTORE-ADH ODAT
TIME FROM TO NOT LATER THAN PRIORITY INTERVAL
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG RESTORE MISSION RSTADHOC ENDED NOTOK
SHOUT WHEN TO URGN
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 10.22.31

General Parameters
General parameters describe the mission and specify the mission type, owner, and
group.

Figure 45 General Parameters

---- CONTROL-V CATEGORY NORTH-COURIER PRT MISSION STD -------(M.S)
COMMAND ===> SCROLL===> CRSR
+----------------------------------------------------------------------------+
CATEGORY DAILY MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP DAILY-PRT
BATCH SKELETON FREE CLOSE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
DESC BUNDLE FOR COURIER TO NORTH BRANCHES
DESC
==============================================================================

Table 43 General Parameters (part 1 of 2)

Parameter Description
CATEGORY Name of the migration, printing, backup, restore mission parameters
of the mission.
MISSION Name of the mission.
MONITOR Number that identifies the print monitor (for printing missions
only).

Chapter 2 Online Facilities 157

Migration, Printing, Backup, Restore Mission Definition Screen

Table 43 General Parameters (part 2 of 2)

Parameter Description
OWNER ID of the owner of the CONTROL-V mission, for security purposes.
TASKTYPE Type of task to be performed by CONTROL-V. Enter MIG for
migration missions.
GROUP Name of the group to which the mission belongs (such as
DAILY-MIG).
DESCM Description of the mission (free text).

Bundling Parameters (Printing Missions Only)

Bundling parameters determine who receives the bundle and the sequence of reports
in the bundle.

Figure 46 Bundling Parameters

===========================================================================
INCLUDE USER NORTH
INCLUDE USER
EXCLUDE USER BR129
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 6,3,8
===========================================================================

Table 44 Bundling Parameters

Parameter Description
M
INCLUDE USER Name of a user (recipient) whose reports are included in the bundle
(the user and the users descendants in the Recipient Tree).
EXCLUDE USERM Name of a user (recipient) whose reports are not included in the
bundle (the user and the users descendants in the Recipient Tree).
SORT Sort keys to be used to sort the reports in the bundle.

Basic Scheduling Parameters

Basic Scheduling parameters specify the day and time to execute the mission.

Figure 47 Basic Scheduling Parameters

DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================

158 CONTROL-D and CONTROL-V User Guide

 Migration, Printing, Backup, Restore Mission Definition Screen

Table 45 Basic Scheduling Parameter

Parameter Description
DAYS Days of the month to schedule the mission.
DCAL DAYS calendar specification.
AND/OR Conjunctional parameter that links parameters DAYS and WDAYS.
WDAYS Days of the week to schedule the mission.
WCAL WDAYS calendar specification.
MONTHS Months to schedule the mission.
DATES Specific dates in the year to schedule the mission.
CONFCAL Name of a calendar used to confirm mission scheduling dates.
SHIFT Indicates if and when a mission should be scheduled when it fails
confirmation by the CONFCAL calendar.
RETRO Yes/No indicator that specifies whether or not the mission is to be
selected (retroactively) after the original scheduling date has passed.
MAXWAIT Number of extra days within which to try to execute the mission if
the original scheduling date of the mission has passed.
MINIMUM Minimum number of free tracks required by the library specified in
parameter PDS. The mission is scheduled even if the number of free
tracks is less than the minimum.a
PDS Name of partitioned dataset to be checked for free space. The
mission is scheduled even if the dataset has less than the minimum
number of required free tracks specified in parameter MINIMUM.a
a
This parameter is supported for compatibility with previous versions.

Basic Scheduling parameters are defined separately for stage 01 migration and for
subsequent migration stages. For more information, see Basic Scheduling
Parameters on page 642.

Runtime Scheduling Parameters

Runtime Scheduling parameters specify requirements that must be satisfied to
execute the mission.

Figure 48 Runtime Scheduling Parameters

MINIMUM PDS
===========================================================================
IN PROD-REPORTS-READY ODAT
TIME FROM 0230 TO NOT LATER THAN 0300 PRIORITY 10
ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT

Chapter 2 Online Facilities 159

Migration, Printing, Backup, Restore Mission Definition Screen

Table 46 Runtime Scheduling Parameters

Parameter Description
INM Prerequisite conditions for the mission.
TIME FROM/TO Time limit for executing the mission.
NOT LATER THAN Time by which mission starts executing even if the prerequisite
conditions do not exist.
PRIORITY Execution priority (compared to other missions).
ON PAGE # Threshold number of pages that triggers (initiates the execution of) a
printing mission.
ON LINE # For future use
INTERVAL Minimum length of time to wait between successive executions of
cyclic restore and printing missions.

Post-Processing Parameters
Post-processing parameters specify what to do when the mission finishes processing
(OK or NOTOK).

Figure 49 Post-Processing Parameters

ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT NORTH-BUNDLE-PRINTED ODAT +
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG PRINTING MISSION STD - NORTH COURIER - ENDED NOTOK
SHOUT WHEN TO URGN
MSG

Table 47 Post-Processing Parameters

Parameter Description
OUTM Prerequisite conditions to be added or deleted when the mission
ends OK.
SHOUTM Message to be sent to a specified destination upon the occurrence of
specific events.
WHEN Specifies that the message is sent when the mission finishes OK,
finishes NOTOK, or does not finish executing by a specified time.
TO Destination of the message (for example, a CONTROL-V user, a TSO
or ROSCOE user, the IOA Log file, or the operator console).
URGN Urgency of message: regular, urgent, or very urgent.
MSG The message (free text).

160 CONTROL-D and CONTROL-V User Guide

 Migration, Printing, Backup, Restore Mission Definition Screen

Mission Specific Parameters

Mission specific parameters are listed below by type of mission and function. These
parameters are only displayed in the mission definition screen for the appropriate
type of mission.

Printing Missions

These parameters specify values that affect the execution of printing missions.

Figure 50 Printing Mission Parameters

MSG
PRINTER PRT1 DEST NODE9 U1234 CHUNKSIZE
ON FORM
REQUEST
===========================================================================
STORE BACKUP MIGRATE

Table 48 Printing Mission Parameters

Parameter Description
M
PRINTER Logical name of the printer for this printing mission.
DEST Unique printer destination (the JES destination), if different from the
destination specified in the installation parameters.
CHUNKSIZE n Number of lines per chunk sent to the spool for printing.
M
ON FORM For future use.
REQUEST For future use.
STORE Yes/No indicator that specifies whether or not a new copy of the
report should be created and stored as a new report file with
embedded print resources. If the report has indexes, this indicator
also specifies whether or not a new copy of the index file should be
created.

Batch Printing Parameters

These parameters enable a printing mission to be run as a batch job.

Figure 51 Batch Printing Parameters

CATEGORY MISSION MONITOR
OWNER TASKTYPE GROUP
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC

Chapter 2 Online Facilities 161

Migration, Printing, Backup, Restore Mission Definition Screen

Table 49 Batch Printing Parameters

Parameter Description
BATCH Yes/No indicator that specifies whether the printing mission is
submitted as a batch job or as a subtask of the print monitor.
SKELETON The name of an existing member in the library referenced by
DD statement DADSKL.
FREE Sysout allocation mode. Value CLOSE indicates that chunking is
implemented and sysout files freed as soon as printed. Value END
indicates that chunking is not used and sysout files are held until the
end of the print job.
TIMEOUT Specifies a number of minutes after the print job begins execution. If
the printing mission does not start before the specified number of
minutes have elapsed, it terminates NOTOK.

Override Values for Printing Missions

The values specified in these parameters supersede the corresponding values

obtained during the decollation process for all reports printed by this mission.

Table 50 Override Values for Printing Missions

Value Description
CLASS Output printing class.
DEST Local or remote printer JES destination (node and user ID) for
printing the report.

If CONTROL-D for Distributed Systems is installed, reports can be

distributed to a Unix or Windows/NT environment by setting the
node value to CTDS. For more information, see CONTROL-D for
Distributed Systems on page 286.
EXTWTR External writer name.
FORM Form to use when printing the report.

162 CONTROL-D and CONTROL-V User Guide

 Migration, Printing, Backup, Restore Mission Definition Screen

Migration Missions

These parameters specify values that affect the execution of migration missions.

Figure 52 Migration Missions in the Migration, Printing, Backup, Restore

Mission Definition Screen
===========================================================================
STAGE 01 SCHEDULING PARAMETERS
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
...
===========================================================================
RETENTION DAYS 00355 FORCE SECONDARY SKELETON MICLIM
CENTERA RETENTION CLASS
===========================================================================
STAGE 01 PRIMARY MEDIA NAME OSS AGE 0030 REFRESH EVERY 0183
PREFIX
SECONDARY MEDIA NAME CART REFRESH EVERY 1460
===========================================================================
MIGRATION PATH SCHEDULING PARAMETERS
DAYS DCAL
AND/OR
WDAYS 0,6 WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
...
STAGE 02 PRIMARY MEDIA NAME FTK2 AGE 0365 REFRESH EVERY 1460
FSET VSET
SECONDARY MEDIA NAME REFRESH EVERY
===========================================================================

Table 51 Migration Mission Parameters (part 1 of 2)

Parameter Description
RETENTION DAYS Number of days to keep migrated reports before they are erased. If
set to 9999, reports are not automatically erased.
FORCE Yes/No indicator that determines if the retention period in
$SYSDATA records created by previous runs of the same migration
mission are (Y) or are not (N) set to the value specified in
RETENTION DAYS. The default is N.
SECONDARY Name of the member in the CONTROL-D SKL library that contains
SKELETON the skeleton job for secondary migration.

Chapter 2 Online Facilities 163

Migration, Printing, Backup, Restore Mission Definition Screen

Table 51 Migration Mission Parameters (part 2 of 2)

Parameter Description
CENTERA This parameter can be specified only by migrating to EMC Centera
RETENTION CLASS storage system. Optional. One of the classes defined in the EMC
Centera environment can be specified. The migrated report will be
kept number of days defined for the specified class in the EMC
Centera definitions. If this parameter is specified, the RETENTION
DAYS parameter is ignored.
STAGE Stage (01 ... 10) in the migration path.
PRIMARY MEDIA Name of the target media for primary migration.
NAME
AGE Age of the report (in days) on which the migration mission can select
this report for migration to the target media of this stage.
REFRESH EVERY Cyclic time interval (in days) between refresh operations (when the
report automatically migrates to a new physical media of the same
type).
PREFIX Prefix of the volume or platter to which files are migrated (for
migration to DASD or OSS only).
FSET FileTek Storage Machine file set (for migration to FileTek).
VSET FileTek Storage Machine volume set (for migration to FileTek).
SECONDARY Name of the target media for secondary migration.
MEDIA NAME

Backup Missions

These parameters specify values that affect the execution of backup missions.

Figure 53 Backup Mission Parameters

TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
# OF DAYS TO KEEP 00031 # OF GENERATIONS TO KEEP
===========================================================================
OUT

Table 52 Backup Mission Parameters

Parameter Description
# OF DAYS TO Number of days to keep backed up reports before they are erased by
KEEP utility CTDCLHIS.
# OF Number of generations of backup mission output to keep. Older
GENERATIONS TO generations are erased by utility CTDCLHIS.
KEEP

164 CONTROL-D and CONTROL-V User Guide

 Editing Mission Definitions in the Edit Environment

Editing Mission Definitions in the Edit Environment

Mission definition parameters can be edited (moved, copied, deleted, repeated) from
within the CONTROL-V Edit environment by performing IOA line editing
commands, similar to standard ISPF line commands.

The EDIT command alternately activates and deactivates the Edit environment of the
Mission Definition screen.

Figure 54 Entering Edit Commands

---- CONTROL-V CATEGORY DAILY PRT MISSION DELPRT --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
__ CATEGORY DAILY MISSION STDPRT MONITOR
__ OWNER M51 TASKTYPE PRT GROUP
__ BATCH N SKELETON FREE CLOSE TIMEOUT 10
__ OVERRIDE CLASS DEST EXTWTR FORM
__ DESC PRINTING MISSION FOR ALL STANDARD FORM REPORTS
__ DESC
__ ===========================================================================
MM INCLUDE USER N44
__ INCLUDE USER N45
MM INCLUDE USER N46
A_ INCLUDE USER N43
__ EXCLUDE USER
__ SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
__ 7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
__ ENTER SORT SEQ : 1
__ ===========================================================================
__ DAYS ALL DCAL
__ AND/OR
__ WDAYS WCAL
__ MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 13.47.47

A 2-character line editing command field, marked by underscores, is displayed for

each line on the screen.

Editing commands are typed directly onto these underscores.

Specified line editing commands are processed when Enter is pressed.

For more information about and examples of editing mission definition parameters in
the Edit environment, see Chapter A, Editing Mission Definitions in the IOA Edit
Environment.

Chapter 2 Online Facilities 165

Exiting the Mission Definition Screen

Exiting the Mission Definition Screen

Use one of the following commands to exit the Mission Definition screen:

Table 53 Exiting the Mission Definition Screen Commands

Command Description
END Keep the changes made to the parameters of the mission and return to the
Category List screen.
CANCEL Do not keep the changes made to the parameters of the mission and return
to the Category List screen.
NEXTCTG Keep the changes made to the parameters of the mission and display the
next mission definition in the Category list.
PREVCTG Keep the changes made to the parameters of the mission and display the
previous mission definition in the Category list.

NOTE
Changes made to the parameters are kept only in memory. They are written to the disk after
exiting the Category List screen.

Automatic Syntax Checking

The definition syntax is automatically checked when the Mission Definition screen is
exited using the END, NEXTCTG or PREVCTG command. If errors are found in the
Mission Definition screen, an error message is displayed. The errors may then be
corrected. If no errors are found, exit to the Category List screen.

Saving Mission Definitions

Press END (PF03/PF15) to exit the Category List screen. If changes have been made
in the Mission Definition facility, an Exit Option window is opened.

166 CONTROL-D and CONTROL-V User Guide

 Ordering Missions

Figure 55 Saving Mission Definition Screen

CATEGORIES OF LIB CTV.PROD.RSTMIS RST MIS RSTADHOC
COMMAN +-----------------------------------------------------------+ ===> CRSR
OPT N | PLEASE SELECT EXIT OPTION | ---------
D | |
===== | SAVE CREATE | <<< =====
| |
| LIBRARY CTD.PROD.RSTMIS |
| MISSION RSTADHOC |
| |
+-----------------------------------------------------------+

OPTIONS: S SELECT D DELETE I INSERT O ORDER F FORCE 11.03.53

Enter Y (Yes) or N (No) in one of the exit options. It is possible to change the name of
the library or mission in the window. You are returned to the Mission List screen or to
the entry panel, depending on where you where when the Category List screen was
entered.

When saving changes using the EXIT option, all of the mission definitions within a
mission are saved, even if changes were made to only one mission definition.

Canceling Changes
To exit without saving mission definition parameter changes, enter the CANCEL
command in the Mission Definition screen, or press RESET (PF04/PF16) in the Exit
Option window of the Category List Screen.

Ordering Missions
The Mission Definition screens are used to define migration, printing, backup and
restore mission criteria. A definition becomes active only after it is ordered. The
report decollating mission can be ordered manually, or it can be ordered
automatically each day. For further information see the CONTROL-D and
CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide. One way to
manually order one or more missions is by using options O and F of the Mission List
or Category List screens.

Chapter 2 Online Facilities 167

Ordering Missions

The options can be activated from:

Mission List screen All mission definitions in the selected mission are ordered.
Category List screen Only the selected mission definition is ordered.

These options are specified as follows:

Table 54 Options for Ordering Missions

Option Description
O (ORDER) Schedule the mission definitions of the mission only if the specified date
is defined as a scheduling date in the mission definitions basic
scheduling criteria.
F (FORCE) Schedule the mission definitions of the mission regardless of basic
scheduling criteria.

When you use the O or F option, a default confirmation window is opened. (If the
default has been modified in the User profile, a different confirmation window,
requiring double confirmation, is opened.)

Figure 56 Order and Force Confirmation Window

MISSION LIST IN CTV.PROD.BKPMIS --------------(M)
COMMAND ===> SCROLL===> CRSR
OPT NAME ------------ VV.MM CREATED CHANGED SIZE INIT MOD ID
BKP0009D 01.01 00/06/29 00/06/29 12:40 15 15 0 PROD
BKP0027D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
BKP0196D +-------------------------------+ 5 0 PROD
BKP0200D | CONFIRM ODATE 080800 |
O BKP0206D <-----------| ASK FOR EACH ONE Y |
BKP0222D +-------------------------------+ 7 0 PROD
BKP0257D 01.01 00/06/29 00/06/29 12:40 15 15 0 PROD
O BKP0271D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
BKP0280D 01.01 00/06/29 00/06/29 12:40 15 15 0 PROD
O BKP0297D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
BKP0332D 01.01 00/06/29 00/06/29 12:40 15 15 0 PROD
BKP0356D 01.00 00/06/30 00/06/30 09:54 7 7 0 PROD
===== >>>>>>>>>>>>>>>>> NO MORE MISSIONS IN LIBRARY <<<<<<<<<<<<<<<<<< ======

OPTIONS: S SELECT O ORDER F FORCE B BROWSE D DELETE 14.39.49

The specified date can be changed. If you decide not to order the mission or mission
definition, enter N in the CONFIRM field (for CANCEL).

168 CONTROL-D and CONTROL-V User Guide

 Copying Migration, Printing, Backup, Restore Mission Definitions to Another Member

The ASK FOR EACH ONE line is only displayed if more than one Order (or Force) is
requested. If you are certain that you want to order or force all indicated missions or
mission definitions, and do not want to change the ODATE for any of the individual
missions or mission definitions, you can bypass individual confirmations by entering
Y in the CONFIRM field and N in the ASK FOR EACH ONE field, and pressing Enter.
All the missions or mission definitions marked O (or F) are ordered.

For each mission or mission definition that is successfully scheduled (ordered), the
following messages are displayed:

Figure 57 CONTROL-D Mission Order Message Window

------------------------ CONTROL-D MISSION ORDER MESSAGES ----------------(M.O)
COMMAND ===> SCROLL===> CRSR
17.24.36 CTD049I MISSION PROCESSING STARTED
17.24.39 CTD528I MISSION BKP0007D ODATE 080800 PLACED ON ACTIVE MISSIONS FILE -
17.24.39 CTD696I ALL MISSIONS PROCESSED SUCCESSFULLY
====== >>>>>>>>>>>>>>>> END OF MESSAGE LIST <<<<<<<<<<<<<<<<< =====
PRESS END TO RETURN, LEFT AND RIGHT TO SEE MORE.

Use the END command (PF03/PF15) to return to the Mission or Category List screen.

Copying Migration, Printing, Backup, Restore Mission

Definitions to Another Member
To copy one or more mission definitions from the current member to another member
(mission), specify option C (Copy) by the mission names in the Category List screen
and press Enter. The window in Figure 58 is displayed.

Chapter 2 Online Facilities 169

Copying Migration, Printing, Backup, Restore Mission Definitions to Another Member

Figure 58 Window for Copying Mission Definitions to Another Mission

CATEGORIES OF LIB: CTV.PROD.RSTMIS PRT MIS STD
COMMAND ===> SCROLL===> CRSR
OPT NAME ------------ VV.MM CREATED CHANGED SIZE INIT MOD ID
C PRINTJOB1 01.01 00/06/29 00/06/29 12:40 15 15 0 PROD

+-----------------------------------------------------------+
| |
| SPECIFY DESTINATION LIBRARY,MEMBER AND CATEGORY NAME |
| |
| LIBRARY : CTV.PROD.RSTMIS |
| MEMBER : |
| CATEGORY: PRINTJOB |
| |
| PRESS END/RESET TO CANCEL ENTER TO PERFORM THE COPY |
+-----------------------------------------------------------+

OPTIONS: S SELECT O ORDER F FORCE B BROWSE D DELETE 14.39.49

The window contains the following fields (some fields contain default values that can
be modified):

Table 55 Fields in the Window for Copying Mission Definitions to

Another Mission
Field Description
Library Library containing the table into which the mission definitions should be
copied. Must be an existing library. Default is the current library.
Member Name of the member (mission) into which the mission definition should
be copied.
Note: A mission definition can only be copied to another member. It
cannot be copied to its own member (even if the mission definition is
renamed).

If the specified member does not exist, the member is created when the
request is performed.
Category Name of the mission definition to be copied. If multiple mission
definitions are selected, the window is initially displayed with the first
selected mission definition. As each request is performed or canceled, the
next requested mission definition name is displayed.

To perform a copy request, press Enter.

To cancel a request, press END (PF03/PF15) or RESET (PF04/PF16).

170 CONTROL-D and CONTROL-V User Guide

 Recipient Tree Definition

Recipient Tree Definition

The CONTROL-D/V Recipient Tree Definition facility provides a series of screens
that enable you to create, view and modify a user Recipient Tree.

The Recipient Tree is stored as a member in a library (partitioned dataset).

The Recipient Tree can contain up to 15 levels of recipients. Each level is identified by
a user defined 2-character code and a full name. Levels are installation defined. For
more information, see Defining the Recipient Tree on page 791 and the
INCONTROL for z/OS Installation Guide.

The Recipient Tree can contain an unlimited number of report recipients.

For information about loading the Recipient Tree, see the CONTROL-D and
CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

Entry Panel
To enter the Recipient Tree facility, select option T on the IOA Primary Option menu.
The IOA Recipient Tree entry panel is displayed.

Figure 59 Recipient Tree Facility Entry Panel

------------------- IOA RECIPIENT TREE - ENTRY PANEL ---------------------(T)
COMMAND ===>
SPECIFY LIBRARY NAME AND MEMBER (TREE) NAME
LIBRARY ===> CTD.PROD.PARM
MEMBER ===> CTDTREE BROWSE (Y/N)
LEVEL 10 OPERATIONS ===>
15 PRESIDENT ===>
20 REGNL-MGMT ===>
25 BRANCH ===>
30 BRANCH-DEPT ===>
50 DIVISION ===>
55 DEPARTMENT ===>
60 SECTION ===>
80 WORKERS ===>
90 CD-CONTROL ===>
95 OP-USER ===>

FOR DIRECT ACCESS, FILL IN RECIPIENT NAME IN APPROPRIATE LEVEL 17.29.25

Chapter 2 Online Facilities 171

Recipient Tree List Screen

NOTE
If you use the selection list fields, their values are not erased until you exit the entry panel by
pressing END (PF03/PF15).

Displaying a Recipient Tree

Specify the desired Recipient Tree by typing the library name and member (tree)
name.

NOTE
The library and member containing the Recipient Tree are installation defined. They should
correspond to the TREE parameter in the CONTROLD and CTDPRINT JCL procedures.

Select the desired display mode (Edit or Browse) by entering Y or N in the BROWSE
field:

Table 56 Fields in the Window for Copying Mission Definitions to Another Mission
Field Description
Y (Yes) The Recipient Tree is displayed in Browse mode. Updates are not permitted
but the CHKTREE command (described later) is permitted.
N (No) The Recipient Tree is displayed in Edit mode. Updates are permitted. Default.

If a specific recipient is desired, type the recipient name (or prefix) next to the
appropriate level.

Press Enter.

Recipient Tree List Screen

This screen displays the list of recipients in a tree, based on the criteria specified in the
entry panel.

For ease of identification, each successive level of the tree is indented from the
previous level.

The Recipient Tree may require more than one screen. Use the scrolling PFKeys to
scroll the tree forward and backward.

172 CONTROL-D and CONTROL-V User Guide

 Recipient Tree List Screen

NOTE
Recipient Tree size is limited only by the region size available for the Online facility.

Figure 60 Recipient Tree List Screen

--------------------- CONTROL-D RECIPIENT TREE ---------------------------(T)
COMMAND ===> SCROLL===> CRSR
LEVELS ===> 10 Y 15 Y 20 Y 25 Y 30 Y 50 Y 55 Y 60 Y 80 Y 90 Y
10 CDTREE CONTROL-D RECIPIENT TREE SAMPLE
20 MGT MANAGEMENT DEPARTMENT
55 MKT MARKETING DEPARTMENT
55 DEV DEVELOPMENT DEPARTMENT
55 PROD PRODUCTION DEPARTMENT
55 WAREHSE WAREHOUSE
25 BR129 THE NORTH COUNTY BRANCH
30 BR129LO THE LOANS DEPARTMENT
30 BR129FC THE FOREIGN CURRENCY DEPARTMENT
30 BR129SA THE SAVINGS DEPARTMENT
55 BMIAMI THE CONTROL-D USER
90 PRODCNTL PRODUCTION CONTROL USER
90 UNIDENT UNIDENTIFIED REPORTS
90 NULL IDENTIFIED REPORTS NOT NEEDED
====== >>>>>>>>>>>>>>>>>>> END OF RECIPIENT TREE <<<<<<<<<<<<<<<<<<<< ======

OPTIONS: D DELETE I INSERT S SELECT P SEE/HIDE PARENT 17.29.39

If the Recipient Tree is displayed in Browse mode, a message indicating this is

displayed at the top of the screen.

NOTE
If a Recipient Tree requested in Edit mode is in use (in Edit mode) by another user, the tree
may be displayed in Browse mode, depending on your User profile definition, and an
appropriate message issued.

Recipient Tree Parameters

The following parameters are displayed for each recipient. This information can be
updated here or in the Recipient Definition screen, which is described in Recipient
Definition Screen on page 176.

LEVELS ===> 10 Y 15 Y 20 Y 25 Y 30 Y 50 Y 55 Y 60 Y 80 Y 90 Y
10 CDTREE CONTROL-D RECIPIENT TREE SAMPLE
55 MKT MARKETING DEPARTMENT
PARENT: MGT LEVEL: 20

Chapter 2 Online Facilities 173

Recipient Tree List Screen

Table 57 Parameters of the Recipient Tree

Parameter Description
LEVELS This parameter allows you to display or hide specific levels in the
tree. The defined levels are listed.

Y (Yes) Display the recipients at that level. Default.

N (No) Do not display the recipients at that level.
LEVEL 2-digit level code (01-99) that is site dependent and reflects the
recipients level in the organization hierarchy.
RECIPIENT NAME Main identifying name of the recipient, up to eight characters. This
name must be unique in the tree.

If you change the level, the line automatically adjusts its indentation
(horizontal position). However, the parent name remains the same
(it is not automatically adjusted). The physical position of the
recipient in the tree does not determine parent and child
relationships. Only the parent field specifies the actual relationship.

A recipient can be the child of any one recipient at a higher level in

the tree.
DESCRIPTION Description of the recipient (free text). Only the first line of the
description is displayed in this screen.
PARENT/LEVEL Parent of the current recipient and the level of the parent. These
parameters can be displayed or hidden as desired.

Options of the Recipient Tree List Screen

To request one of the following options, specify the option in the field to the left of the
recipient name and press Enter.

NOTE
If the screen is displayed in Browse mode, options D (Delete) and I (Insert) are not available.

Table 58 Options of the Recipient Tree List Screen (part 1 of 2)

Option Description
S (SELECT) Display the Recipient Definition screen for the selected recipient.

If the Recipient Tree List screen is displayed in Browse mode, the

Recipient Tree definition can only be browsed; it cannot be modified. If
the Recipient Tree List screen is not displayed in Browse mode, the
Recipient Tree definition can be edited and updated.
D (DELETE) Delete a recipient from the Recipient Tree.

174 CONTROL-D and CONTROL-V User Guide

 Recipient Tree List Screen

Table 58 Options of the Recipient Tree List Screen (part 2 of 2)

Option Description
I (INSERT) Insert a new recipient in the Recipient Tree. The Recipient Tree
Definition screen is displayed. Enter the recipient name and any other
recipient definition information you want. The new recipient is added
after the recipient marked I (at the same level and with the same parent).
You can change the level and/or parent of the new recipient.
P (SEE/HIDE This option allows you to display or hide the parent line of the recipient.
PARENT)

Commands of the Recipient Tree List Screen

Table 59 Recipient Tree List Screen Commands

Command Description
NEXT A name can be used only once as a user name in a Recipient Tree, but
it can be used an unlimited number of times as a synonym in the tree.

If you specify a recipient name (or prefix) next to one of the levels in
the Recipient Tree entry panel, the first recipient whose user name
(or synonym) conforms with that name at that level is displayed at
the top of the Recipient Tree screen.

To display (at the top of the screen) the next recipient who conforms
to the specified criteria, enter the NEXT command on the
COMMAND line.
Note: Synonyms are not displayed in the Recipient Tree screen. If a
matching synonym is found, the cursor is positioned on the name of
the user to whom the synonym belongs.
CHKTREE The CHKTREE command checks the validity of the Recipient Tree.
Type CHKTREE on the command line and press Enter.
Note: This check is performed automatically (by default) when you
save a tree. For more information, see Exiting a Recipient Tree List
Screen on page 178.
If there are no errors in the tree, the tree is automatically sorted
by hierarchy.

If errors exist, the Recipient Tree screen disappears, and

appropriate messages are displayed on a Message List screen. If
the messages span more than one screen, you can scroll forward
and backward through the list.

Press END (PF03/P15) to return to the Recipient Tree screen. Correct

the errors and either perform CHKTREE again or exit from the
screen.

Chapter 2 Online Facilities 175

Recipient Definition Screen

Recipient Definition Screen

The Recipient Definition screen is accessed by specifying option S for the selected
recipient in the Recipient Tree List screen. This screen enables you to see and update
information about a recipient.

Figure 61 Recipient Definition Screen

----------------------- CONTROL-D RECIPIENT DEFINITION -------------------(T.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
RECIPIENT PROD RECIPIENT LEVEL 55 PARENT MGT PARENT LEVEL 20
DESC PRODUCTION DEPARTMENT
DESC
===========================================================================
SYNONYM PRODUCTION
SYNONYM
AUTHORIZE $SYSDATA
ADDRESS
===========================================================================
INDEX Y USER BANNER Y REPORT BANNER Y
DEF DEST
===========================================================================
P C P A R A M E T E R S
AUTHORIZED Y
PC PATH
PC RETAIN 006 (days) MF RETAIN 006 (days)
MAX SIZE 00056000 (lines) TRANSMIT FROM 0300 TO 0600 (hhmm)
======= >>>>>>>>>>>> END OF RECIPIENT DEFINITION PARAMETERS <<<<<<<<<<<< ======

FILL IN RECIPIENT DEFINITION. 17.45.40

Exit the Recipient Definition screen by pressing the END key (PF03/PF15).

This screen displays the following parameters for the selected recipient:

NOTE
Parameters marked with the symbol M can have many occurrences. When you fill in the last
occurrence of the parameter on the screen, a new empty occurrence of that parameter is
added.

Table 60 Recipient Definition Screen Required Fields

Field Description
RECIPIENT Name of the recipient. Maximum length: 8 characters.
RECIPIENT LEVEL Level of the recipient. Two digits, leading zero required.
PARENT Name of the recipients parent. Maximum length: 8 characters.
PARENT LEVEL Level of the recipients parent.

176 CONTROL-D and CONTROL-V User Guide

 Recipient Definition Screen

Table 61 Recipient Definition Screen Optional Fields

Field Description
DESCM Description of the recipient.
M
SYNONYM Another name for the recipient. Maximum length of each synonym:
20 characters. Synonyms may not be unique and may contain
embedded spaces.
AUTHORIZEM Name of online users authorized to access the reports of the recipient
and its descendants. A name prefix can be specified.
$SYSDATAM Is the authorized user or also authorized to access $SYSDATA
entries and to create or modify global rulers. Valid values:
Y/N/blank. Must be blank if the AUTHORIZE field is blank.
Default: blank (which implies N).
ADDRESSM Location to which the user bundle is sent during distribution.
Maximum number of lines: 10. The address can be printed in the
user banner. If **P is specified, the address of the parent is used.
INDEX Print a report index at the beginning of the user bundle. Valid
values: Y/N. Default: Y.
USER BANNER Print a user banner at the beginning and end of the users bundle.
Valid values: Y/N. Default: Y.
REPORT BANNER Print a report banner at the beginning and end of each report in the
bundle. Valid values: Y/N. Default: Y.
DEF DEST Default destination (node and user ID) of printed reports for the
recipient. Each node and user ID can be 1 8 characters.

If CONTROL-D for Distributed Systems is installed, reports can be

distributed to a Unix or Windows NT environment by setting the
node value to CTDS. For more information, see CONTROL-D for
Distributed Systems on page 286.

Table 62 Recipient Definition Screen PC Download Parameters (part 1 of 2)

Parameter Description
AUTHORIZED Indicates whether the user can receive reports via
CONTROL-D/WebAccess Server.

Y (Yes) User can receive reports in CONTROL-D/WebAccess

Server.
N (No) User is not authorized to receive reports in
CONTROL-D/WebAccess Server.
The following parameters are displayed only if AUTHORIZED is set to Y:
PC PATH PC path to which reports are downloaded (drive:\directory). It is
highly recommended that each user have a unique (sub)directory on
the PC.
PC RETAIN Number of days to keep user reports on the PC. Valid range: 000
999.

Chapter 2 Online Facilities 177

Exiting a Recipient Tree List Screen

Table 62 Recipient Definition Screen PC Download Parameters (part 2 of 2)

Parameter Description
MF RETAIN Number of days to keep the bundle ready for transmission on the
mainframe. Valid range: 0 999. Reports remain on the mainframe in
WAIT TRANSMISSION mode until transmitted or until the number
of days specified in MF RETAIN is exceeded.
MAX SIZE Maximum number of lines to download to the PC in one bundle (up
to 8 digits).
TRANSMIT Time interval during which transfer of reports from mainframe to
PC is allowed. Format: From hhmm To hhmm.

Exiting a Recipient Tree List Screen

Press END (PF03/PF15) to exit the Recipient Tree. The Exit Option window is
opened.

Figure 62 Recipient Tree List Screen Exit Option Window

--------------------- CONTROL-D RECIPIENT TREE ----------------------------(T)
COMMAN +--------------------------------------------------------+ LL===> CRSR
LEVELS | PLEASE SELECT EXIT OPTION |
10 | |
| SAVE CREATE |
| |
| CHECK Y |
| |
| LIBRARY CTD.PROD.PARM |
| MEMBER CTDTREE |
| |
+--------------------------------------------------------+
30 BR129FC THE FOREIGN CURRENCY DEPARTMENT
30 BR129SA THE SAVINGS DEPARTMENT
55 BMIAMI THE CONTROL-D USER
90 PRODCNTL PRODUCTION CONTROL USER
90 UNIDENT UNIDENTIFIED REPORTS
90 NULL IDENTIFIED REPORTS NOT NEEDED
====== >>>>>>>>>>>>>>>>>>> END OF RECIPIENT TREE <<<<<<<<<<<<<<<<<<<<< ======

OPTIONS: D DELETE I INSERT S SELECT P SEE/HIDE PARENT 15.32.55

Enter Y or N in either the SAVE or CREATE field. It is possible to change the name of
the library or the name of the tree (member) in the Exit Option window. If you enter
N in either field, no changes are made and you return to the entry panel.

The CHECK field indicates whether or not to check the syntax of the Recipient Tree.

Y (Yes) Check or sort the tree before it is saved. Default.

N (No) Save the tree without performing a check or sort.

178 CONTROL-D and CONTROL-V User Guide

 User Reports (Online Viewing)

NOTE
Whenever the CONTROL-V monitor loads a Recipient Tree, an automatic check or sort is
performed. Only valid recipients are loaded. Error messages are written to the IOA Log file
when invalid recipients are detected.

Syntax Checking
If you respond Y to save or create a new tree and Y to check the syntax, the syntax of
the tree is checked.

If there are no errors in the tree, the tree is automatically sorted by hierarchy and
saved (or created). You are returned to the entry panel.

If errors exist, the Recipient Tree List screen disappears and appropriate messages
are displayed on a Message List screen. If the messages span more than one screen,
you can scroll the list forward and backward. Press END (PF03/P15) to return to
the Recipient Tree List screen. Correct the errors and exit from the screen.

RESET Command

If you have entered an Exit Option window but you do not want to exit the Recipient
Tree screen, press RESET (PF04/PF16). You are returned to the Recipient Tree List
screen without saving the tree.

CANCEL Command

To exit the Recipient Tree List screen without checking the tree syntax and without
opening an Exit Option window, type CANCEL on the command line and press
Enter. Any modifications to the tree are not saved and you return to the entry panel is
displayed.

User Reports (Online Viewing)

To enter the User Reports facility, select option U on the IOA Primary Option menu.
The CONTROL-V User Reports entry panel is displayed.

User Reports facility screens enable the CONTROL-V user to:

Display a list of reports based on index values, report status and other criteria.

Retrieve pages or sections of a report via index values.

Display a list of indexes available for a report.

Chapter 2 Online Facilities 179

Using Indexes for Report Retrieval

View report index values and the number of times each value occurs.

View, edit and print report pages or sections.

Request immediate printing or reprinting of report pages.

Change various report printing parameters including destination, form, output

print class, and number of copies to print.

Cancel the scheduled printing of a report.

Edit (reformat) a report so that it looks different from the original when viewed or
printed.

Delete a report.

Designate new recipients for a report.

Add notes or messages to a report.

Authorize other users to view a report.

Indexes play a central role in retrieving reports for online viewing and immediate
printing. Report indexes enable users to determine if desired information is available
and to retrieve only the desired information for online viewing or printing.

The process of online report retrieval via index values is discussed on the following
pages.

Using Indexes for Report Retrieval

The User Reports facility provides online screens that enable the user to perform the
following functions:

Identify the report from which pages should be retrieved

User Report list

Facilitates using all the available functions provided by the User Reports facility.

Quick Access Report list

Facilitates using the Quick Access Method (described below) for report
retrieval.

180 CONTROL-D and CONTROL-V User Guide

 Using Indexes for Report Retrieval

NOTE
An index name and index values can be used as report selection criteria.

Identify the indexes to be used for retrieval

User Reports entry panel

Provides a field for a main index name.

Index window
Lists main indexes that have been defined for a report.

Subindex window
Lists subindexes that exist for any specified value in a higher level index.

Quick Access panel

Displays a complete index path.

Specify a value for the selected indexes

User Reports entry panel

Provides fields for a main index and its value.

Values of Index panel

Displays an alphabetized list of available values.

Quick Access panel

Provides a value field for each index in an index path.

Specify viewing or immediate printing for the selected report pages

User Report list

Provides options for viewing or printing.

Values of Index panel

Provides options for viewing or printing (if accessed via an Index or Subindex
window).

Quick Access panels

Provides commands for viewing or printing.

The following diagram shows how these online screens are used to retrieve report
pages. A description of the diagram follows.

Chapter 2 Online Facilities 181

Using Indexes for Report Retrieval

Report Access Via Index Values

Figure 63 Report Access Using Index Values

Each arrow in the diagram points from an option or command to the screen displayed
when that option or command is executed. (The dashed line indicates a shortcut that
bypasses the Quick Access Report list if only one report had been listed, or that
bypasses the Index Window if only one index had been listed.) Available options:

Table 63 Quick Access Panel Options

Option Description
P Initiate Immediate Printing of report pages pointed to by the specified
index values.
Q Display the Quick Access Report list or Quick Access panels.
S Display the Values of Index panel for the specified index, or select an
index value to be inserted in a Quick Access panel.
V View report pages pointed to by the specified index values.
X Display the Index window or Subindex window.

182 CONTROL-D and CONTROL-V User Guide

 Using Indexes for Report Retrieval

There are three basic methods of specifying index values for report retrieval:

Table 64 Methods for Specifying Index Values for Report Retrieval

Method Description
Quick Access Method Available from the User Reports entry panel, the User Report
list, or the Index window.
Index / Subindex Window Available from a User Report list.
Method
Hit List Available from the User Reports entry panel.

These methods are described below.

Quick Access Method

Retrieval via the Quick Access Method is especially useful when the index hierarchy
has many levels and when the user is familiar with the reports and indexes available.

The Quick Access Method utilizes Quick Access panels that can be accessed from the
User Reports entry panel, from any Report list, or from the Index window (described
in the following section). Quick Access panels allow the user to quickly display the
available index paths for a report, select the required index path, and specify index
values that are used for report retrieval. Each index path is displayed in a separate
Quick Access panel. The user can display each Quick Access panel until the required
path is displayed.

Once the required path is displayed in a Quick Access panel, the user specifies the
values to be used for retrieval.

If the required values are known, the user can specify them in the Quick Access panel
to view or print the selected report pages. When retrieving a report section via a
migrated index, provide as many values as possible to improve performance.

If the required values are not known, specifying a prefix or asterisk displays the
Values of Index panel with possible values from which to choose. When the user
selects a value, the value is automatically inserted in the Quick Access panel. The
selected report pages or sections can then be viewed or printed.

Index / Subindex Window Method

Retrieval via the Index / Subindex Window Method is especially useful when the
index hierarchy does not have many levels. Index and Subindex windows list the
available main indexes and subindexes.

These windows can only be accessed from the User Report list. The user proceeds
from level to level in the index hierarchy, examines the available index names and
values, and specifies index values until the retrieval criteria are specified.

Chapter 2 Online Facilities 183

Using Indexes for Report Retrieval

Through the User Report list, the main indexes for the selected report can be
displayed in the Index window.

Once the user has reviewed the main indexes in the Index window and selected the
desired main index, the user can proceed in either of two ways:

Display the Quick Access panels. From this point, retrieval continues as described
in Quick Access Method above.

Display the values for the selected main index in the Values of Index panel.

Once a value has been specified in the Values of Index panel, the user can proceed in
one of two ways:

View or initiate immediate printing of the report pages pointed to by the specified
index value.

Display the Subindex window that lists the next level of subindexes available
under the specified higher index value.

In the Subindex window, the user selects the next lower index level and enters its
Values of Index panel to specify the desired value for the selected subindex. The
specified value can be used in one of the two ways outlined above.

Each time the user displays the Subindex window, the index names listed in it and
the values displayed by the Values of Index panel are for the next lower level index in
an index path.

Hit List Method

A Hit List is a list of reports selected according to:

an index name or mask, and

(optionally) an index value or prefix that are specified as part of the report
selection criteria.

The determination of which reports are listed in the User Report list or Quick Access
Report list occurs in stages:

1. In the first stage, reports are filtered by report attributes specified in the User
Reports entry panel (such as report name, user ID, report date range) and the Show
Options window (such as report status).

2. In the second stage, reports are filtered by main index name or mask. If the
selection criteria contain a main index name or mask without an index value or
prefix, reports are selected if they contain the specified index.

184 CONTROL-D and CONTROL-V User Guide

 Using Indexes for Report Retrieval

3. In the third stage, reports are filtered by index value or prefix.

If the selection criteria contain an index value or prefix for a nonresident main
index, reports are selected if they contain the specified index. Nonresident
indexes are not searched for index values.

If the selection criteria contain an index value or prefix for a resident main
index, reports are selected if they contain pages or sections pointed to by the
specified index values.

It is often possible to bypass Index windows and Quick Access panels when accessing
reports that qualify as a Hit List based on an index value or prefix. For example:

If a single index value was retrieved by Hit List filtering, only the report sections
indexed by this value are printed or viewed without the need for additional
filtering via an Index window or Values of Index panel.

If only one index satisfies the retrieval criteria, the Index window is bypassed
when accessing the index.

If only one report is retrieved, the Quick Access Report list is bypassed when using
the Quick Access method.

After retrieving reports that qualify as a Hit List, the user can:

Use regular commands and options, such as View and Print, which access only the
retrieved sections of the report.

Use Quick Access panels. From this point, retrieval continues as described in
Quick Access Method above.

Display the indexes and values as described above in Index/Subindex Window

Method. Only indexes that match the Hit List index retrieval criteria are accessed.

Retrieval Considerations
The following information can be helpful when deciding how to retrieve indexed
reports:

In general, the Quick Access Method is more efficient in terms of the time and
resources required for retrieval. This is especially true if some or all of the required
indexes have migrated and are no longer on DASD.

Chapter 2 Online Facilities 185

Entry Panel

Each Index and Subindex window provides the maximum information about
indexes available at the next level in an index path but these windows provide no
information about other index levels. Each Quick Access panel provides the
maximum information about one index path but that panel provides no
information about other index paths.

When viewing or printing reports, there are advantages if all the selected reports
have the same nonresident main index, or have the same DASD-resident main
index and contain exactly the same main index value or prefix. For more
information, see Hit List Method on page 184.

If a users access to CONTROL-V is limited to Direct Online Viewing (DOLV) and

BYPASS PANEL is set to Q in the User Reports entry panel, the first screen
displayed is the Quick Access Report list (if the user has several reports), or the
Quick Access panels (if the user has only one report).

Job Archiving Retrieval

A Job Archiving facility is available for a special JOBSDSN1 decollation and
consolidation process that creates one large index of the archived jobs. Display type J
facilitates the retrieval and viewing of production job SYSOUTs. For more
information, see User Reports Entry Panel (Display Type J) on page 195.

Entry Panel
Selecting option U on the IOA Primary Option menu displays the User Reports entry
panel unless the panel is bypassed as described below.

The User Reports entry panel is the main user interface to CONTROL-V information
about reports. The OPTIONS field of the entry panel allows you to specify the kind of
Report list you want to display:

Permanent (an inventory of reports processed by CONTROL-V).

Active/Migrated (recently or soon to be processed reports and/or reports that

migrated from DASD to various storage devices). Default.

History (reports backed up on tape or cartridge).

The other fields enable you to specify the criteria used to select the reports that are
displayed. A list of all reports that conform to the specified criteria is displayed on the
User Report list or Quick Access Report list.

The default CONTROL-V security mechanism enables each user to see and update
only their reports and the reports of their subordinates in the Recipient Tree.

186 CONTROL-D and CONTROL-V User Guide

 Entry Panel

There are three display types for the CONTROL-D/V User Reports entry panel: V
(Default panel), A (All fields), and J (Job display).

The fields in display types V, A, and J are described later in this chapter.

The entry panel default display (V) is illustrated below.

Figure 64 User Reports Entry Panel

------------------ CONTROL-D/V - USER REPORTS ENTRY PANEL ----------------(U)
COMMAND ===>
OPTIONS ===> 1. PERMANENT 2. ACTIVE/MIGRATED 3. HISTORY

REPORT NAME ===>

Report name, prefix or mask
USER ===> Recipient name or prefix
DATE FROM ===> TO Report date or relative day
JOBNAME ===> Job name, prefix or mask

SHOW MIGRATED ===> Y Include migrated reports

INDEX ===> Index name, prefix or mask

VALUE ===>

DISPLAY TYPE===> D BYPASS PANEL ===> N

SELECT AN OPTION, FILL IN THE SELECTION CRITERIA, AND PRESS ENTER

In the entry panel and Show Options window, the default 1-character equivalents for
YES and NO are Y and N. installation parameters $USRYES and $USRNO in member
$$FRM of the IOA MSG library can be used to set different 1-character equivalents for
YES and NO.

Changing Entry Panel Display Types

While in the CONTROL-D/V User Reports entry panel, the entry panel display type
can be changed through the DISPLAY command. Format of the command is:

DISPLAY x

where x is a one letter code which identifies the desired display type. DISPLAY can
be abbreviated to DI.

Chapter 2 Online Facilities 187

Entry Panel

NOTE
For a list of display types, enter DISPLAY ? to show the Display Options window. To select a
display type in the window, enter S in the OPTION field next to the ID. To exit the window
without selecting a display type, press the END key (PF03/PF15).

Example

DI A

displays the All Fields display.

Predefined entry panel display:

V Default display
A All Fields display
J Job display

User Reports Entry Panel Fields (Display Type V)

Specify any of the following selection criteria to control which reports are displayed
in User Report lists. The symbol C indicates that the field allows character masking.

Table 65 User Reports Entry Panel Fields (Display Type V) (part 1 of 4)

Field Description
C
REPORT NAME Report name (as set during decollation).
C
USER User (recipient) name. The default is all recipients for which the user
has authorization, if security module CTDSE04 is implemented.
Otherwise, the default is the (first) root of the Recipient Tree.

188 CONTROL-D and CONTROL-V User Guide

 Entry Panel

Table 65 User Reports Entry Panel Fields (Display Type V) (part 2 of 4)

Field Description
DATE FROM/TO Earliest and latest report date for reports to be included in the Report
list. Date criteria are checked against the following types of dates:a

ODATE (original scheduling date)

Decollation date
Job start date

Dates can be specified in the following formats:

mmddyy, ddmmyy or yymmdd, depending on site standard

-n where n is the number (from 0 to 99999) of preceding days. For

example: 3 means three days ago.

LAST (for FROM date only). Limits the display to the latest
generation of each report with the same report name and job
name. This format is especially valuable when bypassing the
User Reports entry panel. The value LAST cannot be specified
unless a specific user is specified in the USER field and the TO
date field is blank.

Entering a FROM date without a TO date implies the FROM and TO

dates are the same. The specified dates are retained when exiting and
reentering the User Reports entry panel.
JOBNAME Name of the job that created the report.
SHOW MIGRATED This parameter determines if active and/or migrated reports are
displayed in the User Reports lists. Valid values:

Y List active and migrated reports. Default.

N List active reports only.
O List migrated reports only.
C
INDEX Index name or mask (1 - 20 characters with no embedded blanks).
Valid mask characters:

* Any number of characters (including none)

? Any one character

An index name or mask is used to select reports and filter indexes

displayed in the Index window. If only one index matches a mask,
the Index window is not displayed but the values of that index are
displayed in the Values of Index panel when accessing the index. If
only one report matches the selection criteria, the Quick Access
Report list is not displayed when using the Quick Access method.

Chapter 2 Online Facilities 189

Entry Panel

Table 65 User Reports Entry Panel Fields (Display Type V) (part 3 of 4)

Field Description
VALUE Index value (1 through 50 characters including embedded blanks).
Enclose the value with single () or double () quote marks only if
trailing blanks must be included.

If the index is disk resident and contains the specified value (or only
one match for the specified prefix), that value is used to select
report sections for View and Print commands. Otherwise, the Values
of Index panel is scrolled to the page that contains the match for
the specified value (as a prefix), when accessing the index.
DISPLAY TYPE Desired Report list display type (or format). Valid values:

D Default for operations personnel

U User for end users
J Job for production control and programmers
S SDSF similar to IBMs SDSF
A All fields

Additional report list display types can be defined.

BYPASS PANEL This parameter determines whether the entry panel is bypassed on
subsequent entry to the User Reports facility. When the entry panel
is bypassed, the last entered set of entry panel values determine
which reports are displayed in the User Report list or Quick Access
Report list.

Valid values:

N The User Report list is displayed and the entry panel is

displayed when you next enter the User Reports facility. Default.

Y The User Report list is displayed. The entry panel is bypassed

when you next enter the User Reports facility and the User
Report list is displayed instead.

Q The Quick Access Report list is displayed. (If only one report
satisfies the selection criteria, the Quick Access Report list is
bypassed and the Quick Access panels are displayed.) The entry
panel is bypassed when you next enter the User Reports facility
and the Quick Access Report list (or Quick Access panel) is
displayed instead.
Note: If you enter Q in this field but want to display the User Reports
entry panel when you next enter the User Reports facility, use the
RETURN command to return to the entry panel before exiting the
User Reports facility and reset the value of this field to N.

190 CONTROL-D and CONTROL-V User Guide

 Entry Panel

Table 65 User Reports Entry Panel Fields (Display Type V) (part 4 of 4)

Field Description
V (View) The User Report list is skipped and the first report on the User
Report list is automatically viewed. Subsequent reports listed on the
first screen of the User Report list are automatically viewed one after
the other.

If the User Report list contains more than the number of reports that
can be listed on one screen, the User Report list is displayed after the
last report on the first screen has been viewed. Otherwise, the User
Reports entry panel is displayed.
a
If the INCONTROL administrator modified the default at time of installation, date criteria
are checked only against ODATE.

Show Options Window

Type SHOW on the command line of the User Reports entry panel (display V) or the
User Report list. Press Enter to display a Show Options window that contains
additional criteria for limiting the reports displayed in the User Report list. The Show
Options window is illustrated below:

Figure 65 User Reports Show Option window

------------------ CONTROL-D/V - USER REPORTS ENTRY PANEL ----------------(U)
COMMAND ===> +--------------------------------------------------------------+
| PLEASE SELECT SHOW OPTIONS |
| |
OPTIONS = | CHILD ===> Y Y-with children |
| REMARK / CCs ===> Remark or CC of job |
| USER REMARK2 ===> Remark2/prefix/mask |
REPORT N | REMARK3 ===> Remark3/prefix/mask |
USER | CATEGORY ===> Category or mask |
DATE FRO | TIME FROM ===> TO Report time |
JOBNAME | |
| SELECT BY STATUS: |
| |
| DECOLLATED ===> Y WAIT DECOLLATION ===> N |
| WAIT PRINT ===> Y RESTORED ONLY ===> N |
| PRINTED ===> Y WAIT RESTORE ONLY ===> N |
| NOT PRINTED ===> Y WAIT BACKUP ONLY ===> N |
| |
| DISPLAY OPTIONS: |
DISPLAY | |
| SHOW RULERS ===> N SHOW CONTROL CHARS ===> Y |
+--------------------------------------------------------------+

SELECT AN OPTION FILL IN THE SELECTION CRITERIA AND PRESS ENTER 07.52.01

Chapter 2 Online Facilities 191

Entry Panel

Show Options Window Fields

Table 66 Show Options Window Selection Criteria (part 1 of 2)

Criteria Description
CHILD This parameter determines whether the reports displayed in the User
Report list are restricted to those of the user (recipient) or also include
reports belonging to the users children in the Recipient Tree.

Y (Yes) Display the users reports and reports of the users

children.
N (No) Display the users reports only.
REMARK / CCs For job MSGCLASS output Highest condition code of the job or the
type of failure in case of failure.

For all output A user-specified remark entered via Decollating

parameter DO REMARK or entered on the User Report list.

The following job statuses are collected from job MSGCLASS output
and can be used as selection criteria:

Cnnnn Condition code

Snnn System abend code
Unnnn User abend code
NCT2NOT CATLGD2
JFAILJob failed due to JCL error

The following status codes are also valid selection criteria:

OK Selects jobs or reports with condition codes in the C0000

C0004 range or reports whose REMARK field is empty (no status
code or remark).a

NOTOK Selects jobs or reports with condition codes greater than

C0004, with various status codes (NCT2, JFAIL, Snnn, Unnnn)
and/or with user remarks.

Selection can be based on remarks generated by the DO REMARK

statement by entering the remark string value.

The greater than operator (>) can be applied to condition codes (for
example, >C0204 selects all jobs that ended with a condition code
greater than 204).

Character masking (described earlier in this chapter) is supported in

the selection string.

Multiple selection strings can be specified by separating them with

commas (for example, S*,U* selects all system and user abends).
REMARK2 A user-specified remark entered using the DO REMARK2 decollating
parameter or entered on the User Report list.

192 CONTROL-D and CONTROL-V User Guide

 Entry Panel

Table 66 Show Options Window Selection Criteria (part 2 of 2)

Criteria Description
REMARK3 A user-specified remark entered using the DO REMARK3 decollating
parameter or entered on the User Report list.
CATEGORY Site-defined category name (such as DAILY or MONTHLY).
TIME FROM/TO Earliest and latest report processing time of day. Time format is
hhmm. Time criteria are matched against:

Report decollation time

Job start time
Job end time

If TIME FROM is later than TIME TO, time is calculated from the
FROM time until midnight and from midnight until the TO time (for
example, FROM 1000 TO 0800 means anytime except between 8:00
a.m. and 10:00 a.m.).
a
The default OK condition codes can be changed by the IOA administrator. Refer to the
CONTROL-D chapter of the INCONTROL for z/OS Installation Guide for details.

Table 67 User Reports Show Option Window Select by Status Parameters

Parameter Description
SELECT BY STATUS

When the following parameters are set to Y, only reports that meet selected report status
criteria are displayed:
DECOLLATED Reports that have been decollated and are available for Online
viewing but are not printed (unless specifically requested by the
Print option).
WAIT Print Reports waiting to be printed.
PRINTED Reports that have already been printed.
NOT PRINTED Reports that were not printed or only partially printed.
WAIT DECOLLATION Reports that have not yet been processed by CONTROL-V.
RESTORED ONLY Reports that have been restored.
WAIT RESTORE ONLY Reports waiting to be restored.
WAIT BACKUP ONLY Reports waiting to be backed up (that is, report deletion has been
postponed because the reports have not been backed up yet).

Table 68 User Reports Show Option Window Display Option (part 1 of 2)

Option Description
SHOW RULERS This parameter determines whether or not report rulers are listed
in the User Reports lists.

Y (Yes) Display defined report rulers.

N (No) Do not display defined report rulers. Default.

Chapter 2 Online Facilities 193

Entry Panel

Table 68 User Reports Show Option Window Display Option (part 2 of 2)

Option Description
SHOW CONTROL This parameter determines whether or not printing control
CHARS characters are displayed in the Report Viewing screen.

Y (Yes) Display printing control characters (for example, line

skips, page breaks).
N (No) Do not display printing control characters. Default.

Bypassing the Entry Panel

When you enter Y (Yes) in the BYPASS PANEL field on the entry panel, the User
Report List screen is displayed whenever you enter the User Reports facility. The
User Report list is discussed in User Reports (Online Viewing) on page 179.

You can enter Q (Quick Access) in the BYPASS PANEL field on the entry panel to
display the Quick Access Report list or Quick Access panel whenever you enter the
User Reports facility. The Quick Access Report list or Quick Access panel are
discussed in Quick Access Report List on page 226.

When bypassing the entry panel, the last selection values previously set in the entry
panel are applied to the User Report list.

Reaccessing the Entry Panel

After you have set the BYPASS PANEL field to Y, you can access the entry panel by
pressing the END key (PF03/PF15) from a Report List screen.

After you have set the BYPASS PANEL field to Q, you can access the entry panel by
using the RETURN command from the Quick Access Report list or pressing the
RETURN key (PF04/PF16) from the Quick Access Panel.

To access the entry panel the next time you enter the User Reports facility, set the
value of the BYPASS PANEL field to N or V. For more information, see the description
of the BYPASS PANEL field in Table 65.

User Reports Entry Panel (Display Type A)

Display type A of the User Reports entry panel combines the options and fields in
display type V of the User Reports entry panel with the fields in the Show Options
window for display type V. Display type A functionality is identical to the combined
functionality of display type V and its Show Options window.

To obtain display type A, type DISPLAY (or its abbreviation DI) followed by a space
and the letter A on the command line of the User Reports entry panel and press Enter.
Display U of the CONTROL-D/V User Reports entry panel is illustrated below:

194 CONTROL-D and CONTROL-V User Guide

 Entry Panel

Figure 66 User Reports Entry Panel (Display Type A)

-------------------- CONTROL-D/V - USER REPORTS ENTRY PANEL ---------------(U)
COMMAND/OPTION ===> 1. PERMANENT 2. ACTIVE/MIG 3. HISTORY
SELECT BY:
REPORT NAME ===>
USER ===> Recipient name or prefix
CHILD ===> Y Y-with children
JOB NAME ===> Job name, prefix or mask
REMARK/ CCs ===> Remark or CC of job
USER REMARK2 ===> Remark2, prefix or mask
REMARK3 ===> Remark3, prefix or mask
CATEGORY ===> Category or mask
DATE FROM ===> TO Report date or relative day
TIME FROM ===> TO Report time
MIGRATED ===> N Include migrated reports
INDEX ===> Index name, prefix or mask
VALUE ===>
SELECT BY STATUS / DISPLAY OPTIONS:
Decollated ===> Y Wait decollation ===> N
Wait print ===> Y Restored only ===> N
Printed ===> Y Wait restore only ===> N
Not printed ===> Y Wait backup only ===> N
Bypass panel ===> N Show rulers ===> N
Display type ===> D Show control chars ===> Y

SELECT AN OPTION, FILL IN THE SELECTION CRITERIA, AND PRESS ENTER 08.40.07

The description and usage of each field is identical to that of display type V. For
complete information about each field see User Reports Entry Panel Fields (Display
Type V) on page 188.

To obtain display type V (or J), type DISPLAY (or its abbreviation DI) followed by a
space and the letter V (or J) on the command line of the User Reports entry panel and
press Enter. Display V (or J) of the CONTROL-D/V User Reports entry panel is
displayed.

User Reports Entry Panel (Display Type J)

Display J of the CONTROL-D/V User Reports entry panel facilitates access to reports
produced by the Job Archiving facility. For more information about this facility, see
the CONTROL-D and CONTROL-V chapter of the INCONTROL for z/OS
Administrator Guide.

Display J of the User Reports entry panel is illustrated below.

Chapter 2 Online Facilities 195

Entry Panel

Figure 67 CONTROL-V User Reports Entry Panel (Display Type J)

-------------------- CONTROL-D/V - USER REPORTS ENTRY PANEL ---------------(U)
COMMAND/OPTION ===> 1. PERMANENT 2. ACTIVE/MIG 3. HISTORY
SELECT BY:
REPORT NAME ===>
Report name, prefix or mask
USER ===> PRODJCL Recipient name or prefix
CHILD ===> Y Y-with children
CATEGORY ===> Category or mask
DATE FROM ===> TO Report date or relative day
SHOW MIGRATED ===> Y Include migrated reports

INDEX VALUE SELECTION:

JOBNAME ===> Job name, prefix or mask
JOBID ===> Job number, prefix or mask
CCs ===> CC of job
TIME FROM ===> TO Report time
SYSTEM ID ===> SMF ID, prefix or mask

DISPLAY OPTIONS:
BYPASS PANEL ===> N SHOW RULERS ===> N
DISPLAY TYPE ===> J SHOW CONTROL CHARS ===> Y

The entry panel is divided into the following sections:

Table 69 User Reports Entry Panel Sections

Section Description
SELECT BY Report selection criteria.
INDEX VALUE SELECTION Special criteria for selection of reports produced by the Job
Archiving facility.
DISPLAY OPTIONS Options that affect the format of User Report lists and the
reports that are viewed.

INDEX VALUE SELECTION contains criteria used to select one of the following:

Original reports created by the generic mission

Reports with the jobname ARCHIVE created as part of the consolidation process.

The INDEX VALUE criteria are used to make a search of the JOBNAME index to
select the matching entries. The JOBNAME field is used both as a report selection
criterion and as an argument to the index content search.

NOTE
For a non-consolidated job, specifying JOBNAME ARCHIVE as a selection criterion in User
Reports Entry Panel (Display Type J) will result in an empty Report List (message IOAE53E
THERE IS NO DATA TO DISPLAY).

196 CONTROL-D and CONTROL-V User Guide

 Entry Panel

When the display is set to J in the User Reports entry panel, the Active and History
Report List display defaults to J. For more information see Display Type J (Job) on
page 209.

For entries that belong to either group, the user can enter line command X to receive a
list of JOBNAMEs that are included in the entry. If only one entry would be
displayed, the index value list of the JOBNAME index is displayed.

The index value list has a single value for entries before consolidation, and multiple
values for entries after consolidation. The user can use line command V to view the
full output of the job, or line command X to see entries in the DDNAMES subindex
for the selected job.

To obtain display J, type DISPLAY (or its abbreviation DI) followed by a space and
the letter J on the command line of the User Reports entry panel and press Enter.

The description and usage of each field is identical to that of display V. For complete
information about each field, see User Reports Entry Panel Fields (Display Type V)
on page 188.

Index Value Selection

The parameters in this chapter specify consolidated index value search arguments.

Table 70 Consolidated Index Value Search Arguments (part 1 of 2)

Argument Description
JOBNAME Job name, prefix or mask (used for selecting either original reports or
consolidated reports with that jobname).
JOBID Job number.
CCs Completion code of job. Use for selecting reports with the specified
completion code. The following selection criteria can be specified:

Cnnnn - condition code

Snnn - system abend code
Unnnn - user abend code
NCT2 - NOT CATLGD2
JFAIL - job failed due to JCL error
>Cnnnn - select jobs with condition codes greater then Cnnnn
OK - Select jobs or reports with condition codes in the C0000 -C0004
range or reports with empty condition code
NOTOK - Select jobs or reports with condition codes greater than
C0004 and with various status codes such as NCT2, JFAIL, Snnn, and
Unnnn.
TIME FROM Time in hhmm format. Jobs that ended before the specified time are not
selected.

Chapter 2 Online Facilities 197

Entry Panel

Table 70 Consolidated Index Value Search Arguments (part 2 of 2)

Argument Description
[TIME] TO Time in hhmm format. Jobs that ended after the specified time are not
selected.
SYSTEM ID SMF ID, prefix or mask of the system in which the job ran.

To obtain display V or A, type DISPLAY (or its abbreviation DI) followed by a space
and the letter V or A on the command line of the User Reports entry panel and press
Enter. The requested display of the CONTROL-D/V User Reports entry panel is
displayed.

Entry Panel Options: Kinds of Report Lists

Select one of the following kinds of Report lists by entering the appropriate option
number in the OPTION field:

1. Permanent Report List: A list of all reports that the user can receive at any time.
Modifications to the data on this list (such as the migration schedule) are valid for
every subsequent execution of the report until modified in the future.

2. Active/Migrated Report List: A list of reports that recently have been or soon will
be decollated, and/or reports that have migrated to various storage devices. The
SHOW MIGRATED field in the User Reports entry panel determines whether the
list contains only reports that have migrated, only reports that have not migrated,
or both.

3. History Report List: A list of all reports that are currently backed up on tape or
cartridge. The list is used to request a restore of lost reports. The length of time for
which reports are backed up is determined by the INCONTROL administrator.

If you do not specify an option number and simply press Enter, the default is option 2,
the Active/Migrated Report list.

198 CONTROL-D and CONTROL-V User Guide

 Report Lists

Figure 68 User Reports Report Lists

Report Lists
Report lists display a list of reports available for processing (viewing, printing,
restoring, and so on).

There are two types of Report lists:

User Report list Various display types are available.

Quick Access Report list The display type cannot be changed.

Header Line
The header line at the top of the screen indicates the User Report list display type (or
Q to designate the Quick Access Report list) and the main selection criteria values
specified in the entry panel.

ACTIVE LIST <A> JOB PRDRPT01 REP SALARY REPORT USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR

Chapter 2 Online Facilities 199

Report Lists

Table 71 User Report List Header Line

Header Field Values
type _of LIST type_of is Permanent, Active or History.
<display_type> display_type is code letter D Default, U User, J Job, or S SDSF.
JOB job_name job_name is the job name (or prefix or mask as specified).
REP report_name report_name is the first 20 characters of the report name (or prefix or
mask as specified).
USR user_name user_name is the user (recipient) name (or prefix or mask as
specified).
CHILD (or blank) If this field contains the word CHILD (because parameter CHILD
was set to Y), reports of the users children (as defined in the
Recipient Tree) are included in the Report list. If this field is blank
(by default or because parameter CHILD was set to N), only the
users own reports are included in the Report list.

Sort Order
Reports that match User Reports entry panel and Show Options window selection
criteria are sorted in the following order:

User ID, job name or report name (depending on an installation parameter value),
Active/Migrated status (if parameter Show Migrated is set to Y), and decollation date
and time.

The INCONTROL administrator can modify this default sort order for any user by
modifying parameter SUS2SRTI in the User profile member. In addition, the SORT
command (described later in this chapter) enables the user to change the order of the
reports displayed in the User Report list.

Additional Info (Option A)

Entering A (Additional Info) in the OPTION field of a listed report alternately
displays and hides additional information about the selected report.

Use this option to show a full report name if its length is longer than 20 characters.

User Report List Display Types

The User Report list is displayed when the BYPASS PANEL field of the User Reports
entry panel is set to Y or N. The various display types are discussed on the following
pages. Display types can be changed via the DISPLAY command that is described
later in this chapter under Commands of the User Report List.

200 CONTROL-D and CONTROL-V User Guide

 Report Lists

Display Type D (Default)

Below are examples of Default display types of Permanent, History and Active User
Report lists intended for use by the INCONTROL administrator and operations
personnel. Fields labeled below are discussed on the next page.

Figure 69 User Report List Display Type D (Default) Permanent List

PERMANENT LIST <D> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT NAME more+ JOB COP FORM C DEST UDEST WTR
MGT EMPLOYEES REPORT PREMPLR2 DFT STD X RMT2
MGT BANKING REPORT M22RPTS 000 STD X RMT2
MKT EMPLOYEES REPORT PREMPLR2 DFT STD X

Figure 70 User Report List Display Type D (Default) History List

HISTORY LIST <D> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT more + ODATE PAGES LINES STATUS
MGT BANKING REPORT 08/08/00 40 1839 Wait restore
MKT EMPLOYEES REPORT 08/08/00 328 14361 Backed up

Figure 71 User Report List Display Type D (Default) Active List

ACTIVE LIST <D> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT more + ODATE PAGES LINES V N STATUS
DEV EMPLOYEES REPORT 08/08/00 2 91 V A Printed
DEV EMPLOYEES REPORT 08/08/00 1 10 V Wait Print
MGT EMPLOYEES REPORT 08/08/00 1 27 Printed
MGT EMPLOYEES REPORT 08/08/00 1 18 G Wait Print
MGT BANKING REPORT 08/08/00 23 1062 Decollated
MGT BANKING REPORT 08/08/00 5 256 V T Decollated
MKT EMPLOYEES REPORT 08/08/00 3 131 Printed
MKT EMPLOYEES REPORT 08/08/00 286 10864 Wait Print
PROD INVENTORY REPORT 08/08/00 97 4127 V Printed
PROD INVENTORY REPORT 08/08/00 10 426 Wait Print
PROD EMPLOYEES REPORT 08/08/00 8 369 V T Printed
PROD EMPLOYEES REPORT 08/08/00 3 169 Wait Print
====== >>>>>>>>>>>>>>>>>> NO MORE REPORTS IN THE LIST <<<<<<<<<<<<<<<<<< ======
P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT
X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 08.02.09

Table 72 Fields in the Default (D) Display Type (part 1 of 2)

Field Description
USER Name of the report recipient as defined in the decollating mission.
REPORT (NAME) First 20 characters of the full name of the report as defined in the
more + decollating mission.
ODATE Original scheduling date (date report was originally scheduled to be
run).
PAGES Number of pages in the report.
LINES Number of lines in the report.

Chapter 2 Online Facilities 201

Report Lists

Table 72 Fields in the Default (D) Display Type (part 2 of 2)

Field Description
V View indicator. Usage is optional and is determined by parameter
SUSRVEW in the User profile member. If not used, it is blank. This field
may be used as a 1-character flag:

blank Report has never been viewed

Y Report has been viewed

Can also be used as a 1, 2, or 3 digit counter:

blank Report has never been viewed

1 to 9, 1 to 99, or 1 to 255 Number of times report was viewed
* Report viewed over 9 or 99 times
STATUS Current status of the report. For more information, see Statuses in the
Report Lists on page 218.
JOB Name of the job that creates the report.
COP Copy count to be used when the report is printed. Valid values are 0 up
to the maximum number allowed, and DFT (the default number of
copies). The maximum and DFT are set in the Report Decollating
parameters by authorized personnel.
FORM Form to use when printing a report on the mainframe computer.
CONTROL-V does not validate this field. Validation is the users
responsibility.
C Output printing class. Can be updated under JES2. Under JES3, output is
printed in a system defined class that is not under user control.
DEST/UDEST Remote printer JES destination (node and user ID) for printing the report.
When omitted, the report is printed on the main computer printer.
Special destination codes CTDPC and CTDPCPRT direct the output for
downloading to a PC (for CONTROL-D/WebAccess Server users only).
WTR External writer name.
N Note indicator. Indicates the type of notes, if any, attached to the report:
blank No notes
G General note
T Tag notes
A Both General and Tag notes
For details about notes, see Notepad Facility on page 241.

Display Type D Additional Info

Below are examples of the Additional Info option specified in the Default display
type of the Permanent, History and Active User Report lists. Fields labeled below are
discussed on the next page.

202 CONTROL-D and CONTROL-V User Guide

 Report Lists

Figure 72 User Report List Display Type D Additional Info Permanent List
PERMANENT LIST JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT NAME more + JOB COP FORM C DEST UDEST WTR
MGT EMPLOYEES REPORT PREMPLR2 DFT STD X RMT2
REPORT NAME: EMPLOYEES REPORT
From User :
Additional Users: DP-MGR
Print Missions : STD
Category: AFP
Pagedef: A Formdef: Output: Chars: ****
MGT BANKING REPORT M22RPTS 000 STD X RMT2

Figure 73 User Report List Display Type D Additional Info History List
HISTORY LIST <D> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT more + ODATE PAGES LINES STATUS
MGT BANKING REPORT 08/08/00 40 1839 Wait restore
REPORT NAME: BANKING REPORT
Run: 08/08/00 12:57 - 13:03 Decollated: 08/08/00 13:04
Copies: 001 Form: STD Class: X
Remarks: C0000
Dest : WTR:
MKT EMPLOYEES REPORT 08/08/00 328 14361 Backed up

Figure 74 User Report List Display Type D Additional Info Active List
HISTORY LIST <D> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT more + ODATE PAGES LINES STATUS
MGT BANKING REPORT 08/08/00 40 1839 Wait restore
REPORT NAME: BANKING REPORT
Run: 08/08/00 12:57 - 13:03 Decollated: 08/08/00 13:04
Copies: 001 Form: STD Class: X
Remarks: C0000
Dest : WTR:
Additional Users:

MKT EMPLOYEES REPORT 08/08/00 328 14361 Backed up

HISTORY LIST <D> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES LINES STATUS
MGT BANKING REPORT 08/08/00 40 1839 Wait restore
Run: 08/08/00 12:57 - 13:03 Decollated: 08/08/00 13:04

Table 73 Additional Info Fields in the Default (D) Display Type (part 1 of 2)
Field Description
Report name Full name of the report as defined in the decollation mission.
Run Date and (from/to) time the report was produced (displayed only if
MSGCLASS output is decollated).
Decollated Date and time the report was decollated.

Chapter 2 Online Facilities 203

Report Lists

Table 73 Additional Info Fields in the Default (D) Display Type (part 2 of 2)
Field Description
Copies Copy count to be used when the report is printed. Valid values: 0 to the
maximum number allowed, and DFT (the default number of copies).
The maximum and DFT are set in the report decollating parameters by
authorized personnel.
Form Form to use when printing a report on the mainframe computer.
CONTROL-V does not validate this field. Validation is the users
responsibility.
Class Output printing class. Can be updated under JES2. Under JES3, output
is printed in a system defined class that is not under user control.
Dest Required remote printer JES destination (node and user ID) for
printing the report. When omitted, the report is printed on the main
computer printer. Special destination codes CTDPC and CTDPCPRT
direct the output for downloading to a PC (for users of
CONTROL-D/WebAccess Server only).
WTR External writer name.
Remarks Three remarks generated by the DO REMARK, DO REMARK2, and
DO REMARK3 options of the report decollating mission. The first
remark may also be a Condition code. It is the highest condition code
from among the job-execution, or other job-termination codes
including

system and user abend codes

NCT2 (NOT CATLGD 2)
JFAIL (JCL error).
Note: Condition codes and termination codes are available only for
MSGCLASS output.

If there is more than one remark in each field, remarks are separated
by commas. The user can update the remark under certain specific
display types.
Category Category name (an installation defined term, such as DAILY or
MONTHLY).
Job Name of the job that creates the report.
JN Job ID (JNUM). JES job number of the job that created the report.
Additional Users List of other users to whom this report is distributed in addition to the
current user. Updates can be made before the report is decollated. By
default, only users in the Recipient Tree can be specified. However, if
the SUS2TRE Profile variable is set to N (No), the Recipient Tree is not
checked for the specified users.
Print Missions Missions used to print the report. The printing mission usually
represents the paper type (for example, STD).
Fromuser Name of the user from which this report (part) has been received.

For a description of the Pagedef, Formdef, Output, and Chars fields, see Display Type
U Additional Info on page 207.

204 CONTROL-D and CONTROL-V User Guide

 Report Lists

Display Type U (User)

Below are examples of User display type for the Permanent, Active and History User
Report lists. Since only the end users own reports are displayed, this display type
does not include the USER field. Fields labeled below are discussed on next page.

Figure 75 User Report List Display Type U (User) Permanent List

PERMANENT LIST <U> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O REPORT NAME more + COP FORM C DEST UDEST WTR FROMUSER
EMPLOYEES REPORT DFT STD X RMT2
BANKING REPORT 000 STD X RMT2
INVENTORY REPORT 000 STD X

Figure 76 User Report List Display Type U (User) History List

HISTORY LIST <U> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O REPORT more + ODATE PAGES LINES V COP STATUS REMARK
EMPLOYEES REPORT 08/08/00 1 18 001 Wait restore
BANKING REPORT 08/08/00 9 558 001 Backed up
BANKING REPORT 08/08/00 5 256 001 Backed up

Figure 77 User Report List Display Type U (User) Active List

ACTIVE LIST <U> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O REPORT more + ODATE PAGES LINES V COP STATUS REMARK
EMPLOYEES REPORT 08/08/00 1 18 001 Wait print
BANKING REPORT 08/08/00 5 256 001 Decollated
INVENTORY REPORT 08/08/00 519 23838 3 001 Wait print
GENERAL LEDGER 08/08/00 220 8354 002 Printed
ANNUAL REPORT 08/08/00 24385 998704 001 Decollated
SALARY REPORT 08/08/00 104 4116 001 Printed
====== >>>>>>>>>>>>>>>>>> NO MORE REPORTS IN THE LIST <<<<<<<<<<<<<<<<<< ======

P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT

X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 08.02.09

Chapter 2 Online Facilities 205

Report Lists

Table 74 Fields in the User (U) Display Type

Field Description
REPORT (NAME) First 20 characters of the name of the report as defined in the
more + decollating mission.
ODATE Original scheduling date (date the report was originally scheduled to
be run).
PAGES Number of pages in the report.
LINES Number of lines in the report.
VIEW View indicator. Usage is optional and is determined by the SUSRVEW
parameter in the User profile member. If not used, it is blank. This field
can be used as a 1-character flag:

blank Report has never been viewed

Y Report has been viewed

VIEW can also be used as a 1, 2 or 3 digit counter:

blank Report has never been viewed

1 to 9, 1 to 99, or 1 to 255 Number of times report was viewed
* Report viewed over 9 or 99 times
COP Copy count to be used when the report is printed. Valid values: 0 to the
maximum number allowed, and DFT (the default number of copies).
The maximum and DFT are set in the report decollating parameters by
authorized personnel.
STATUS Current status of the report. This topic is discussed below.
REMARK Condition code and/or remark.

Highest condition code from the job execution, or other job

termination codes including system and user abend codes, NCT2
(NOT CATLGD 2) or JFAIL (JCL error).a Remarks can also be
generated by the DO REMARK option of the report decollating
mission. If there is more than one remark, remarks are separated by
commas. The user can update the remark under certain display types.
FORM Form to use when printing a report on the mainframe computer.
CONTROL-V does not validate this field. Validation is the users
responsibility.
C Output printing class. Can be updated under JES2. Under JES3, output
is printed in a system defined class that is not under user control.
DEST/UDEST Remote printer JES destination (node and user ID) for printing the
report. When omitted, the report is printed on the main computer
printer. Special destination codes CTDPC and CTDPCPRT direct the
output for downloading to a PC (for users of
CONTROL-D/WebAccess Server only).
WTR External writer name.
FROMUSER Name of the user from which this report (part) has been received.
a
Condition codes and termination codes are available only for MSGCLASS output.

206 CONTROL-D and CONTROL-V User Guide

 Report Lists

Display Type U Additional Info

When using option A with display type U, the following Additional Info fields are
displayed on the screen. Fields labeled below are discussed on the next page.

Figure 78 User Report List Display Type U Additional Info Permanent List
PERMANENT LIST <U> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O REPORT NAME more + COP FORM C DEST UDEST WTR FROMUSER
EMPLOYEES REPORT DFT STD X RMT2
REPORT NAME: EMPLOYEES REPORT
Additional Users:

Print Missions : STD

Category: DAILY User: MGT Job: PREMPLR2
Pagedef: A Formdef: Output: Chars: ****
BANKING REPORT 000 STD X RMT2
INVENTORY REPORT 000 STD X

Figure 79 User Report List Display Type U Additional Info History List
HISTORY LIST <U> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O REPORT more + ODATE PAGES LINES COP STATUS REMARK
EMPLOYEES REPORT 08/08/00 1 18 001 Wait restore
REPORT NAME: EMPLOYEES REPORT
Run: 08/08/00 21:19 - 21:34 Decollated: 08/08/00 21:35
Form: STD Class: X
Dest: WTR
Remarks: C000
BANKING REPORT 08/08/00 9 458 001 Backed up
BANKING REPORT 08/08/00 5 256 001 Backed up
INVENTORY REPORT 08/08/00 519 23838 001 Backed up

Figure 80 User Report List Display Type U Additional Info Active List
ACTIVE LIST <U> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O REPORT more + ODATE PAGES LINES V COP STATUS REMARK
EMPLOYEES REPORT 08/08/00 1 18 001 Wait print
REPORT NAME: EMPLOYEES REPORT
Run: 00:00 - 00:00 Decollated: 08/08/00 11:06
Form: STD Class: D
Dest: WTR:
Remarks: C0000
Additional Users:

BANKING REPORT 08/08/00 5 256 001 Decollated

INVENTORY REPORT 08/08/00 519 23838 001 Wait print
GENERAL LEDGER 08/08/00 220 8354 002 Printed
ANNUAL REPORT 08/08/00 24385 998704 001 Decollated
SALARY REPORT 08/08/00 104 4116 001 Printed
====== >>>>>>>>>>>>>>>>>> NO MORE REPORTS IN THE LIST <<<<<<<<<<<<<<<<<< ======

V VIEW E EDIT P PRINT U UPDT I INS D DEL N NOTE A ADD INFO G GIVETO 13.16.13

Chapter 2 Online Facilities 207

Report Lists

Table 75 Additional Info Fields in the User (U) Display Type

Field Description
Report name Full name of the report as defined in the decollation mission.
Run Date and (from/to) time the report was produced (displayed only if
MSGCLASS output is decollated).
Decollated Date and time that the report was decollated.
Form Form to use when printing a report in the mainframe computer.
CONTROL-V does not validate the syntax of the form or its
correctness. Validation is the users responsibility.
Class Output printing class. Can be updated under JES2. Under JES3, output
is printed in a system defined class that is not under user control.
Dest Required remote printer JES destination (node and user ID) for
printing the report. When omitted, the report is printed on the main
computer printer. Special destination codes CTDPC and CTDPCPRT
direct the output for downloading to a PC (for users of
CONTROL-D/WebAccess Server only).
WTR External writer name.
Remarks Three remarks generated by the DO REMARK, DO REMARK2, and
DO REMARK3 options of the report decollating mission. The first
remark may also be a Condition code. It is the highest condition code
from among the job-execution, or other job-termination codes
including

system and user abend codes

NCT2 (NOT CATLGD 2)
JFAIL (JCL error).
Note: Condition codes and termination codes are available only for
MSGCLASS output.

If there is more than one remark in each field, remarks are separated
by commas. The user can update the remark under certain specific
display types.
Category Category name (a site-defined term, such as DAILY or MONTHLY).
Fromuser Name of the user from which this report (part) has been received.
Job Name of the job that creates the report.
Additional Users List of other users to whom this report is distributed in addition to the
current user. Updates can be made before the report is decollated. By
default, only users in the Recipient Tree can be specified. However, if
the SUS2TRE Profile variable is set to N (No), the Recipient Tree is not
checked for the specified users.
Print Missions Missions used to print the report. The printing mission usually
represents the paper type (for example, STD).
Pagedef PAGEDEF (for AFP output).
Formdef FORMDEF (for AFP output).
Output Name of output statement.
Chars Character sets.

208 CONTROL-D and CONTROL-V User Guide

 Report Lists

Display Type J (Job)

Below are examples of the Job display type for Active and History Report lists,
including the Additional Info fields. Display type J is intended for operations
personnel or programmers. It is usually used to view MSGCLASS output. Fields
labeled below are discussed on the next page.

Figure 81 User Report List Display Type Job (J) History List
HISTORY LIST <> JOB REP USR PRODCNTL CHILD (U)
COMMAND ===> SCROLL===> CRSR
O JOBNAME JNUM STARTED ENDED PAGES REMARK STATUS
PRDRPTS2 8879 08/08/00 08:53 08:58 8 C0000 Backed up
Ordered: 08/08/00 Decollated: 08/08/00 09:01
PRDKPL01 9723 08/08/00 09:21 09:28 186 S0C4 Restored
M22PRO1 8042 08/08/00 09:29 09:35 54 C0000 Backed up
M22PRO2 8059 08/08/00 09:38 09:54 48 C0000 Backed up
M010ERM 8068 08/08/00 09:56 10:21 79 C0000 Backed up
M200EP3 8100 08/08/00 10:25 10:25 3 JFAIL Backed up
M22PARM 8218 08/08/00 10:27 10:39 51 C0000 Backed up
M12AWDT 8423 08/08/00 11:02 11:19 5 C0004 Wait restore
M08STMIS 9261 08/08/00 11:21 11:42 97 S222 Backed up

Figure 82 User Report List Display Type Job (J) Active List
ACTIVE LIST <> JOB REP USR PRODCNTL CHILD (U)
COMMAND ===> SCROLL===> CRSR
O JOBNAME JNUM STARTED ENDED PAGES LINES V REMARK
PRDRPTS2 8879 08/08/00 08:47 08:47 5 78 C0000
Ordered: 08/08/00 Decollated: 08/08/00 14:42
PRDKPL01 9723 08/08/00 09:17 09:17 4 186 S0C4
M22PRO1 8042 08/08/00 09:28 09:32 4 54 C0000
M22PRO2 8059 08/08/00 09:47 09:56 4 48 C0000
M010ERM 8068 08/08/00 09:48 10:22 17 679 C0000
M200EP3 8100 08/08/00 10:29 10:29 15 583 JFAIL
M22PARM 8218 08/08/00 11:58 11:58 9 251 C0000
M12AWDT 8423 08/08/00 14:50 14:51 24 855 C0004
M08STMIS 9261 08/08/00 15:07 15:10 331 16497 S222
M0869REP 9262 08/08/00 15:08 15:10 320 16021 U1024
M225MANL 8443 08/08/00 15:08 15:08 8 539 C0000
M225MSGD 8463 08/08/00 15:21 15:21 9 701 C0012
M28RPTU 8521 08/08/00 16:07 16:32 12 954 C0016
M12WTO2 8650 08/08/00 18:20 18:21 83 3641 C0004
M12AMWTO 8655 08/08/00 18:23 18:24 152 6737 C0000
PRDKPL01 8657 08/08/00 18:25 18:25 4 185 S0C4
M14TES1 8690 08/08/00 18:51 18:51 4 47 C0000
M19SMPJ 8716 08/08/00 19:18 20:06 135 6143 S222
P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT
X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 08.02.09

Table 76 Fields in the Job (J) Display Type (part 1 of 2)

Field Description
JOBNAME Name of the job that created the report.
JNUM JES job number of the job that created the report.
STARTED Date and time the job began executing. (Valid only for MSGCLASS
output.)

Chapter 2 Online Facilities 209

Report Lists

Table 76 Fields in the Job (J) Display Type (part 2 of 2)

Field Description
ENDED Time the job finished executing. (Valid only for MSGCLASS output.)
PAGES Number of pages in the report.
LINES Number of lines in the report.
VIEW View indicator. Usage is optional and is determined by the SUSRVEW
parameter in the User profile member. If not used, it is blank. This field
can be used as a 1-character flag:

blank Report has never been viewed

Y Report has been viewed

VIEW can also be as a 1, 2 or 3 digit counter:

blank Report has never been viewed

1 to 9, 1 to 99, or 1 to 255 Number of times report was viewed
* Report viewed over 9 or 99 times
REMARK Condition code and/or remark.

Highest condition code from the job execution, or other job

termination codes including system and user abend codes, NCT2
(NOT CATLGD 2) or JFAIL (JCL error).a Remarks can also be
generated by the DO REMARK option of the decollating mission. If
there is more than one remark, remarks are separated by commas. The
user can update the remark under certain display types.
STATUS Current status of the report. For more information, see Statuses in the
Report Lists on page 218.
a Condition codes and termination codes are available only for MSGCLASS output.

Table 77 Additional Info Fields In the Job (J) Display Type

Field Description
Ordered Original scheduling date (date report was originally scheduled to be
run).
Decollated Date and time that the report (job) was decollated.

Display Type S (SDSF)

Below are examples of the SDSF display type for Active and History Report lists
including the Additional Info fields. (SDSF is an IBM program facility.) This format is
similar to the SDSF display of jobs in the Held output queue. Fields labeled below are
discussed on the next page.

210 CONTROL-D and CONTROL-V User Guide

 Report Lists

Figure 83 User Report List Display Type S (SDSF) History List

HISTORY LIST <> JOB REP USR PRODCNTL CHILD (U)
COMMAND ===> SCROLL===> CRSR
O JOBNAME TYP JNUM END-DATE C FORM DEST TOT-RC PAGES STATUS
M08STMIS JOB 2153 08/08/00 0 STD 16497 331 Backed up
Ordered: 08/08/00 Run: 08/08/00 14:27 To: 14:28 Decollated: 08/08/00 14:42
M20INSCD JOB 2168 08/08/00 0 STD 37 3 Backed up
M12AWDT JOB 2123 08/08/00 0 STD 855 24 Backed up
M225MANL JOB 2202 08/08/00 0 STD 539 8 Backed up
M225MSGD JOB 2218 08/08/00 0 STD 701 9 Wait restore
PRDKPL01 JOB 2329 08/08/00 0 STD 39 3 Backed up
PRDKPL01 JOB 2336 08/08/00 0 STD 39 3 Backed up
M12WTO2 JOB 2385 08/08/00 0 STD 3641 83 Backed up
M12AMWTO JOB 2409 08/08/00 0 STD 6737 152 Backed up

Figure 84 User Report List Display Type S (SDSF) Active List

ACTIVE LIST <> JOB REP USR PRODCNTL CHILD (U)
COMMAND ===> SCROLL===> CRSR
O JOBNAME TYP JNUM END-DATE C FORM DEST TOT-RC PAGES REMARK
M22RTT1 JOB 8042 08/08/00 0 STD 54 4 C0000
Ordered: 08/08/00 Run: 08/08/00 14:27 To: 14:28 Decollated: 08/08/00 14:42
M22MNF1 JOB 8059 08/08/00 0 STD 48 4 C0000
M200EP3 JOB 8100 08/08/00 0 STD 583 15 U0016
M22PARM JOB 8218 08/08/00 0 STD 251 9 C0000
M20INSCD JOB 8365 08/08/00 0 STD 37 3 JFAIL
M12AWDT JOB 8423 08/08/00 0 STD 855 24 C0004
M225MANL JOB 8443 08/08/00 0 STD 539 8 C0000
M225MSGD JOB 8463 08/08/00 0 STD 701 9 C0012
PRDKPL01 JOB 8513 08/08/00 0 STD 39 3 JFAIL
PRDKPL01 JOB 8639 08/08/00 0 STD 39 3 JFAIL
M12WTO2 JOB 8650 08/08/00 0 STD 3641 83 C0004
M12AMWTO JOB 8655 08/08/00 0 STD 6737 152 C0000
PRDKPL01 JOB 8657 08/08/00 0 STD 185 4 S0C4
M14EMF1 JOB 8690 08/08/00 0 STD 47 4 C0000
M19SMPJ JOB 8716 08/08/00 0 STD 6143 135 S222
PRDRPTS2 JOB 8862 08/08/00 0 STD 5 78 C0000
PRDRPTS4 JOB 8879 08/08/00 0 STD 78 5 C0000
M08STMIS JOB 9261 08/08/00 0 STD 16497 331 S722
M0869REP JOB 9262 08/08/00 0 STD 16021 320 S222
P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT
X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 08.02.09

Table 78 Fields in the SDSF (S) Display Type (part 1 of 2)

Field Description
JOBNAME Name of the job that creates the report.
TYP 3-letter code of the job ID.
JNUM Numeric part of the job ID.
END-DATE Date of decollation.
C Output printing class. Can be updated under JES2. Under JES3, output
is printed in a system defined class that is not under user control.
FORM Form to use when printing a report on the mainframe computer.
CONTROL-V does not validate this field. Validation is the users
responsibility.

Chapter 2 Online Facilities 211

Report Lists

Table 78 Fields in the SDSF (S) Display Type (part 2 of 2)

Field Description
DEST Remote printer JES destination (node and user ID) for printing the
report. When omitted, the report is printed on the main computer
printer. Special destination codes CTDPC and CTDPCPRT direct the
output for downloading to a PC (for users of
CONTROL-D/WebAccess Server only).
TOT-RC Total number of records (data lines) in the report.
PAGES Number of pages in the report.
REMARK Condition code and/or remark.

Highest condition code from the job execution, or other job

termination codes including system and user abend codes, NCT2
(NOT CATLGD 2) or JFAIL (JCL error).a Remarks can also be
generated by the DO REMARK option of the report decollating
mission. If there is more than one remark, remarks are separated by
commas. The user can update the remark under certain display types.
STATUS Current status of the report. For more information, see Statuses in the
Report Lists on page 218.
a Condition codes and termination codes are available only for MSGCLASS output.

Table 79 Additional Info Fields in the S (SDSF) Display Type

Field Description
Ordered Original scheduling date (date report was originally scheduled to be
run).
Run Date and (from/to) time the report was produced (displayed only if
MSGCLASS output is decollated).
Decollated Date and time that the report was decollated.

Display Type L (Long)

Below are examples of the Long display type for Permanent, History and Active User
Report lists, intended for use by the INCONTROL administrator and operations
personnel. Data for each report entry data is located on two lines. Fields labeled
below are discussed on the next page.

Figure 85 User Report List Display Type L (Long) Permanent List

PERMANENT LIST <D> JOB REP USR CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT NAME COP FORM C DEST UDEST JOB/WTR
MGT EMPLOYEES REPORT PREMPLR2
DFT STD X RMT2
MKT BANKING REPORT M22RPTS
000 STD X RMT2
MKT EMPLOYEES REPORT PREMPLR2
DFT STD X

212 CONTROL-D and CONTROL-V User Guide

 Report Lists

Figure 86 User Report List Display Type L (Long) History List

HISTORY LIST <D> JOB REP USR M* CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES LINES V N JOB/STATUS
MGT BANKING REPORT M22RPTS
08/08/00 40 1839 Wait restore
MKT EMPLOYEES REPORT PREMPLR2
08/08/00 328 14361 Backed up

Figure 87 User Report List Display Type L (Long) Active List

ACTIVE LIST <D> JOB REP USR M* CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES LINES V N JOB/STATUS
MGT BANKING REPORT M22RPTS
08/08/00 40 1839 V T Decollated
MKT EMPLOYEES REPORT PREMPLR2
08/08/00 328 14361 Wait Print
DEV EMPLOYEES REPORT PREMPLR2
08/08/00 2 91 V A Printed
DEV EMPLOYEES REPORT PREMPLR2
08/08/00 1 10 V Wait Print
MGT EMPLOYEES REPORT PREMPLR2
08/08/00 1 27 Printed
MKT BANKING REPORT M22RPTS
08/08/00 23 1062 Decollated
====== >>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<< ======

Table 80 Fields in the Long (L) Display Type

Field Description
REPORT (NAME) Full name of the report as defined in the decollating mission.
JOB/WTR Name of the job that creates the report in the first line of the report entry.
External writer name in the second line of the report entry.
JOB/STATUS Name of the job that creates the report in the first line of the report entry.

Current status of the report in the second line of the report entry. For
more information, see Statuses in the Report Lists on page 218.

For a description of the fields, see Table 72 on page 201.

Display Type L Additional Info

Below are examples of the Additional Info option specified in the Long display type
of the Permanent, History and Active User Report lists. Additional Info fields are
discussed on the next page.

Chapter 2 Online Facilities 213

Report Lists

Figure 88 User Report List Display Type L Additional Info Permanent List
PERMANENT LIST <D> JOB REP USR CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT NAME COP FORM C DEST UDEST JOB/WTR
MGT EMPLOYEES REPORT PREMPLR2
DFT STD X RMT2
From User :
Additional Users: DP-MGR

Print Missions : STD

Category: AFP
Pagedef: A Formdef: Output: Chars: ****
MKT BANKING REPORT M22RPTS
000 STD X RMT2

Figure 89 User Report List Display Type L Additional Info History List
HISTORY LIST <D> JOB REP USR M*CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES LINES V N JOB/STATUS
MGT BANKING REPORT M22RPTS
08/08/00 40 1839 Wait restore
Run: 08/08/00 12:57 - 13:03 Decollated: 08/08/00 13:04
Copies: 001 Form: STD Class: X
Remarks: C0000
Dest : WTR:
MKT EMPLOYEES REPORT PREMPLR2
08/08/00 328 14361 Backed up

Figure 90 User Report List Display Type L Additional Info Active List
ACTIVE LIST <D> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES LINES V N JOB/STATUS
MGT BANKING REPORT M22RPTS
08/08/00 40 1839 V T Decollated
Run: 08/08/00 12:57 - 13:03 Decollated: 08/08/00 13:04
Copies: 001 Form: STD Class: X
Remarks: C0000
Dest : WTR:
Additional Users:

MKT EMPLOYEES REPORT PREMPLR2

08/08/00 328 14361 Wait Print

For a description of the fields, see Table 80 on page 213 and Table 73 on page 203.

Display Type A (All Fields)

Below are examples of the All Fields display type for Permanent, Active and History
Report lists. The fields in these examples are discussed below.

214 CONTROL-D and CONTROL-V User Guide

 Report Lists

Figure 91 User Reports List Display Type A (All Fields) Permanent List
PERMANENT LIST <A> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT NAME COP FORM C DEST JOB/WTR
DEV EMPLOYEES REPORT PREMPRS2
DFT STD X
From User
Additional Users:
Print Missions : STD
Category: DAILY
------------------------------- end of record ---------------------------------
MGT EMPLOYEES REPORT PREMPRS2 000 STD X RMT2
From User:

Figure 92 User Reports List Display Type A (All Fields) History List
HISTORY LIST <A> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT NAME JOB JOBNUMB
DEV EMPLOYEES REPORT PRDDRPT1 5833
CATEGORY DAILY FROMUSER
Ordered: 08/08/00 Run: 08/08/00 11:42 To: 12:03 Decollated: 08/08/00 12:04
Status : Wait restore View:
Remarks: C0000
Copies : 001 Form : STD Class: X P- 42 L- 1683
Dest: WTR:
Record ID : ACC672C4 9E6A8000 RBA: 00000118 UPDT: ACC67755 92F23E00

Figure 93 User Reports List Display Type A (All Fields) Active List
ACTIVE LIST <A> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT NAME JOB JOBNUMB
DEV EMPLOYEES REPORT PRDDRPT1 5833
CATEGORY: DAILY FROMUSER:
Ordered: 08/08/00 Run: 00:00 To: 00:00 Decollated: 08/08/00 15:20
Status : Printed View: V
Remarks:
Copies : 001 Form : STD Class: X P- 2 L- 91
Dest: WTR: : A
Record ID : ACED682C 86EFE200 RBA: 00000111 UPDT: ACED8AAC 8F040000
Print Missions : PRT1
Pagedef: Formdef: Output: Chars: ****
Additional Users :

------------------------------- end of record --------------------------------

DEV EMPLOYEES REPORT PRDDRPT1 JOB 5833 DAILY
Ordered: 08/08/00 Run: 00:00 To: 00:00 Decollated: 08/08/00 15:31
Status : Wait Print Remark : View: V
Copies : 001 Form : STD Class: X P- 1 L- 10
Dest: WTR: :
Record ID : ACD70AAA 3778F400 RBA: 00000116 UPDT: ACD70B2F 82074000
Print Missions : PRT2
V VIEW E EDIT P PRINT U UPDT I INS D DEL N NOTE A ADD INFO G GIVETO 13.16.13

Chapter 2 Online Facilities 215

Report Lists

Table 81 Fields in the All Fields (A) Display Type (part 1 of 2)

Field Description
USER Name of the report recipient as defined in the decollating mission.
REPORT NAME Full name of the report as defined in the decollating mission.
JOB Name of the job that creates the report.
JOBNUM JES job number of the job that created the report.
CATEGORY Category name (a site-defined term, such as DAILY or MONTHLY).
FROMUSER Name of the user from which this report (part) has been received.
Ordered The date the report was originally scheduled to be run.
Run/To Date and (from/to) time the report was produced (displayed only if
output is decollated).
Decollated Date and time that the report was decollated.
Status Current status of the report. For more information, see Statuses in the
Report Lists on page 218.
Remarks Condition code and/or remark.

Highest condition code from the job execution, or other job

termination codes including system and user abend codes, NCT2
(NOT CATLGD 2) or JFAIL (JCL error).a Remarks can also be
generated by the DO REMARK option of the report decollating
mission. If there is more than one remark, remarks are separated by
commas. The user can update the remark under certain display types.
VIEW View indicator. Usage is optional and is determined by parameter
SUSRVEW in the User profile member. If not used, it is blank. This
field can be used as a 1-character flag:

blank Report has never been viewed

Y Report has been viewed

VIEW can also be used as a 1, 2 or 3 digit counter:

blank Report has never been viewed

1 to 9, 1 to 99, or 1 to 255 Number of times report was viewed
* Report viewed over 9 or 99 times
Copies Copy count to be used when the report is printed. Valid values are 0 to
the maximum number allowed, and DFT (the default number of
copies). The maximum and DFT are set in the report decollating
parameters by authorized personnel.
Form Form to use when printing a report on the mainframe computer.
CONTROL-V does not validate this field. Validation is the users
responsibility.
Class Output printing class. Can be updated under JES2. Under JES3, output
is printed in a system defined class which is not under user control.

216 CONTROL-D and CONTROL-V User Guide

 Report Lists

Table 81 Fields in the All Fields (A) Display Type (part 2 of 2)

Field Description
Dest Remote printer JES destination (node and user ID) for printing the
report. When omitted, the report is printed on the main computer
printer. Special destination codes CTDPC and CTDPCPRT direct the
output for downloading to a PC (for users of
CONTROL-D/WebAccess Server only).
WTR External writer name.
P Number of pages in the report.
L Number of lines in the report.
Record ID Timestamp indicating when the record was created.
Print Missions Missions used to print the report. The printing mission usually
represents the paper type (for example, STD).
Restore Mission Mission used to restore the report from tape or cartridge to disk.
Pagedef PAGEDEF (for AFP output).
Formdef FORMDEF (for AFP output).
Output Name of output statement.
Chars Character set.
Additional Users List of other users to whom this report is distributed, in addition to the
current user. Updates can be made before the report is decollated. By
default, only users in the Recipient Tree can be specified. However, if
the SUS2TRE Profile variable is set to N (No), the Recipient Tree is not
checked for the specified users.
Note Note indicator. Indicates the type of notes, if any, attached to the
report:

blank No notes
G General note
T Tag notes
A Both General and Tag notes

For details about notes, see Notepad Facility on page 241.

RBA Address of the record in the file.
UPDT Timestamp indicating when the record was last changed.
a
Condition codes and termination codes are available only for MSGCLASS output.

Display Type A Additional Info

When using option A with display type A, the following Additional Info fields are
displayed on the Active and History Report list screens. Labeled fields are discussed
below.

Chapter 2 Online Facilities 217

Report Lists

Figure 94 User Report List Display Type A Additional Info History List
HISTORY LIST <A> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT NAME JOB JOBNUMB
DEV EMPLOYEES REPORT PRDDRPT1 5833
CATEGORY DAILY FROMUSER
Ordered: 08/08/00 Run: 08/08/00 11:42 To: 12:03 Decollated: 08/08/00 12:04
Status : Wait restore View:
Remarks: C0000
Copies : 001 Form : STD Class: X P- 42 L- 1683
Dest : WTR:
Record ID : ACC1B390 7957FC00 RBA: 00000225 UPDT: ACC2C775 B5A4B000
Print Missions :

Figure 95 User Report List Display Type A Additional Info Active List
ACTIVE LIST <A> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT NAME JOB JOBNUMB
DEV EMPLOYEES REPORT PRDDRPT1 5833
CATEGORY: DAILY FROMUSER:
Ordered: 08/08/00 Run: 00:00 To: 00:00 Decollated: 08/08/00 15:20
Status : Printed View: V
Remarks:
Copies : 001 Form : STD Class: X P- 2 L- 91
Dest: WTR: :
Record ID : ACC1BBFD DE290800 RBA: 00000229 UPDT: ACC2C775 C7C61000
Print Missions : PRT1
V VIEW E EDIT P PRINT U UPDT I INS D DEL N NOTE A ADD INFO G GIVETO 13.16.13

Table 82 Additional Info Fields in the All Fields (A) Display Type
Field Description
CDAM-FILE Name of the CDAM file that contains the report.
NAME
sequence-num Sequence number of the CDAM file (1 20). More than 20 CDAM files
can be used but only the first 20 are displayed.
tot-num Total number of CDAM files pointed to by the record.
FIRST-RBA / Relative byte address of the first and last record of the CDAM file
LAST-RBA belonging to the report.

Statuses in the Report Lists

The STATUS field indicates the current report stage. The following statuses may
appear:

218 CONTROL-D and CONTROL-V User Guide

 Report Lists

Table 83 User Report List STATUS Field Values

Value Description
Wait decollation Report has not yet been processed. Records with this status are created
by utility CTDCP2A.
Decollated Report has been processed and is available for viewing. The report
does not print unless specifically requested by the P (Print) option.
Decollated-notok Report has been processed to completion, but an error occurred during
processing, or a DO NOTOK has been activated. The report does not
print unless specifically requested by the P (Print) option.
Wait migr The report has been decollated and indexed but has not yet migrated.
The report and indexes are available for viewing.
Migrated The report has migrated to a storage device. The report and indexes
are available for viewing.
Wait print Printing of the report has been requested but the report has not yet
been printed. The report is available for viewing.
Printed Report has been printed. It is available for viewing.
Not printed Report was scheduled for printing but, for some reason, did not print
or did not print completely.
Wait bkp Report is no longer needed for viewing but is waiting to be backed up,
after which it is automatically deleted from the Active Report list.
Backed up Regular status in the History list.
Wait restore A restore request is pending.
Restored A restore request for this report has been executed. The report has been
restored from tape or cartridge to disk. The report is available for
viewing (and printing by request).

User Report List Search Continuation Window

If user report search confirmation is implemented at your site, the Search
Continuation window (shown below) is opened when a specified number of records
have been rejected during a User Report file search. The current number of rejected
and selected records is displayed in the window.

The Search Continuation window allows the user continue the search until all records
have been examined, or to cancel the search.

Chapter 2 Online Facilities 219

Report Lists

Figure 96 User Report Search Continuation Window

ACTIVE LIST <D> JOB REP USR CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES LINES V N STATUS

+---------------------------------------------+
| |
| NUMBER OF REJECTED RECORDS: 000500 |
| NUMBER OF SELECTED RECORDS: 000009 |
| |
| PLEASE SELECT ONE OF THE FOLLOWING: _ |
| |
| 1 - STOP SEARCH IMMEDIATELY |
| 2 - ASK AGAIN AFTER 000500 RECORDS |
| 3 - UNCONDITIONAL SEARCH |
| |
+---------------------------------------------+

P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT

X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 15.34.53

To perform a search, select one of the following choices and press Enter.

3 UNCONDITIONAL SEARCH

Searches all records in the User Report file.

The search continues uninterrupted unless and until you select option 1 (Stop Search
Immediately).

2 ASK AGAIN AFTER number RECORDS

Searches the User Report file until the specified number of rejected records is met,
and then pauses. The search number can be modified. Valid values are 000001
through 999998, or 999999 (see the Note below). Default:500.

Continue the search by pressing Enter.

Stop the search by selecting option 1 (Stop Search Immediately).

NOTE
If you enter 999999, the search is unlimited and the Search Continuation window is not
displayed in future searches. In this case, only the INCONTROL administrator is able to reset
this number.

If any records are selected, the User Report List is displayed listing those records.

220 CONTROL-D and CONTROL-V User Guide

 Report Lists

During the search, the following information is displayed at the top of the window:

Number of rejected records. Lists the cumulative number of records rejected.

Number of selected records. Lists the cumulative number of records selected.

For example, if after the first search 500 records are rejected and 20 records are
selected, the number of rejected records displayed is 500 and the number of selected
records displayed is 20. If after the next search 30 more records are selected, the
number of rejected records displayed is 1000 and the number of selected records
displayed is 50. In this example, a total of 1050 records were searched.

If any records are selected during the search, the User Report List is displayed listing
those records. If no records are selected, the Search Continuation Window is closed
and a message is displayed.

Options of the User Report List

The following options can be applied to individual reports: (The INCONTROL
administrator can change predefined options (letters). For details, see the
INCONTROL for z/OS Installation Guide.)

Table 84 Options of the User Report List (part 1 of 2)

Option Description
P (PRINT) (Active User Report list)

Print entire report or selected pages via a specific index value (or via
a prefix that matches a unique index value).
X (INDEX) (Active User Report list)

List the reports indexes (which match any specified index mask) in
the Index window where the user can select an index to display its
Values of Index panel or its Quick Access panel. The Index window
is not displayed if it would contain only one index; the Values of
Index panel for that index is displayed instead. For more
information, see Index Window on page 233.
V (VIEW) (Active User Report list)

View entire report or the pages selected via a specific index value (or
via a prefix that matches a unique index value). Create and modify
rulers that enhance the appearance of viewed reports.
N (NOTE) (Active User Report list)

Open a Note Window for the report. For more information, see
Notepad Facility on page 241.

Chapter 2 Online Facilities 221

Report Lists

Table 84 Options of the User Report List (part 2 of 2)

Option Description
U (UPDATE) (All User Report lists)

Update the User Report list with changes made to non-protected

(Can be updated) fields. Update requests are recorded in the IOA
Log file.

A confirmation window may be displayed, depending on profile

variable SUSRUPDW.
G (GIVETO) (Active User Report list)

Provide a copy of the report to another user after the report is

decollated.
I (INSERT) (Active and Permanent User Report lists)

This option is for experienced operations personnel. Insert a new

report data line. Fill in data (user name, report name, copy count,
and so on) and press Enter. In order to insert a line containing a long
report name (more than 20 characters in length), use the display type
L (Long). Inserted lines can be deleted by the D (Delete) option.
D (DELETE) (All User Report lists)

Delete the entire report. Delete requests are recorded in the IOA Log
file.

A confirmation window may be displayed, depending on profile

variable SUSRDELW.
A (ADD INFO) (All User Report lists)

Toggle between displaying and hiding additional report

information.
Q (QUICK ACCESS) (Active User Report list)

Display the Quick Access panels of a report to retrieve and view

report pages based on report index values.
E (EDIT) (Active User Report list)

Access the Report Editing (Ruler) screen directly from the Active
User Report list to edit reports that have not migrated. For more
information, see Editing (Reformatting) Reports on page 253.
R (RESTORE) (History User Report list)

Restore a report from tape or cartridge to disk.

C (NO-RESTORE) (History User Report list)

Cancel a restore request.

222 CONTROL-D and CONTROL-V User Guide

 Report Lists

Commands of the User Report List

General Commands

Use the scrolling conventions to scroll the User Report list forward (PF08/PF20) and
backward (PF07/PF19). Use the FIND command to search for a specified string in the
Report list. Use the END command (PF03/PF15) to exit the Report list and return to
the previously displayed screen. Use the RETURN command to exit the Report list
and return to the User Reports entry panel. Use the =X command to exit the entire
Online User Reports facility and return to your normal operating environment.

Table 85 User Report List General Commands (part 1 of 2)

Command Description
REFRESH The REFRESH command (PF04/PF16) refreshes the display of the
current User Report list. The selection criteria are activated again and a
new list is produced containing reports that were added to the list since
the last time the list was entered. The command also refreshes the status
of the existing reports in the list.
DISPLAY While in a User Report list, you can change the display type by using the
DISPLAY command. Format:

DISPLAY x

where x is the identifying letter for the desired display type. DISPLAY
can be abbreviated DI.

Example:

DISPLAY U displays the User display type of the User Report list.
RULER Rulers are sets of screen editing rules that can be used to modify the
appearance of reports. The RULER command can be used in the Active
(but not the Permanent or History) User Report list to alternately turn
the ruler show mode on and off. When the ruler show mode is ON,
rulers currently defined for each report are displayed on the Active
Report list. The default mode is set in parameter SHOW RULERS of the
Show Options window.
SHOW Enter SHOW on the Command line of the User Report list and press
Enter. The Show Options window is displayed. This Show Options
window enables users to enter additional selection criteria and then
redisplay the User Report list. For more information, see Show Options
Window on page 191.

Chapter 2 Online Facilities 223

Report Lists

Table 85 User Report List General Commands (part 2 of 2)

Command Description
SORT Records in the User Report list are automatically displayed in default
sort order. (The INCONTROL administrator can modify the default sort
order for each user.) Command SORT enables the user to change the
order in which User Report list records are displayed. (For more
information see SORT PARAMETERS Window below.)

Command SORT can be specified with or without parameters. If

specified without parameters, the Sort Parameters window (below) is
opened. This window allows the user to specify a sort based on one or
more (maximum 5) fields in ascending or descending order. The sortable
fields are listed in the Sort Parameters window.

SORT PARAMETERS Window

Figure 97 SORT PARAMETERS Window

ACTIVE LIST JOB REP USR ADMIN SORT (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES LINES V N STATUS
JONES NEW DAY REPORT
08/08/00 3 6 Wait print
JONES NEW DAY REPORT
+----------------------------------------------------------------------------+
| |
| SORT PARAMETERS |
| |
| 1 USER 7 DECOLLATION DATE + TIME |
| 2 JOB NAME 8 REMARK |
| 3 REPORT NAME 9 JOBID |
| 4 CATEGORY 10 FORMS |
| 5 ODATE 11 COPIES |
| 6 RUN DATE + TIME 12 PRINT MISSION |
| |
| SPECIFY FIELD NUMBER AND A OR D FOR SORT ORDER |
| |
| SORT FIELDS ===> 03 - A 05 - D - - - |
| |
| ENTER Y TO PERFORM SORT Y |
| |
+----------------------------------------------------------------------------+

Fill in the Sort Parameters window as follows:

Table 86 SORT PARAMETERS Window Fields

Field Description
SORT FIELDS Enter sort order parameters: field number to the left of the hyphen
and A (ascending) or D (descending) to the right of the hyphen.
ENTER Y TO Enter Y to exit the window and sort the User Report list. Enter N to
PERFORM SORT exit the window and return to the User Report list without
performing the sort.

224 CONTROL-D and CONTROL-V User Guide

 Report Lists

When reentering the User Report list, records are displayed in default sort order.
However, the sort order parameters last used in the Sort Parameters window are
retained in the window.

The Sort Parameters window is bypassed if the SORT command includes one or more
parameters. The maximum number of parameters is 5. Each parameter is preceded by
a blank and consists of a sort field number and the letter A (ascending) or D
(descending). The sort field numbers are identical to those displayed in the Sort
Parameters window.

For example, SORT 3A 5D specifies a sort by REPORT NAME (ascending) and

ODATE (descending).

The default sort order of the User Report list can be modified using parameter
SUS2SRTI in the User profile member. For more information, see the CONTROL-D
and CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

Displaying Stored Reports

Stored reports are created by a printing mission with parameter STORE set to YES.
Typically, they are displayed in CONTROL-D/WebAccess Server using
CONTROL-D/Page On Demand. For more information, see STORE: Mission-
specific Parameter on page 736.

By default, entries of stored reports are not displayed in the Active User Report List
screen. However, they are displayed in the Active User Report List screen if
command STORED is entered on this screens command line.

Valid command arguments:

Table 87 STORE Command Arguments

Argument Description
YES Both stored and non-stored reports are displayed in the Active
User Report List screen. Default for the command.
ONLY Only stored reports are displayed in the Active User Report List
screen.
NO Stored reports are not displayed in the Active User Report List
screen. (Default if the command is not entered.)

NOTE
You can modify stored report viewing by changing the User profile parameter SUS2STOR.
For more information, see the INCONTROL for z/OS Administrator Guide > IOA
administration > IOA Profiles > Profile Variables.

Chapter 2 Online Facilities 225

Report Lists

Quick Access Report List

The Quick Access Report list is displayed when the BYPASS PANEL field of the User
Reports entry panel is set to Q and more than one report satisfies the selection criteria.

In the Quick Access Report list, option Q displays Quick Access panels for the
selected report. If option Q is specified for more than one report at a time, the
requests are stacked in the order listed. When the Quick Access panel for the first
report is displayed, use the END command (PF03/PF15) to access the Quick Access
panel for the next report in the stack.

Below is an example of the Quick Access Report list. Labeled fields are discussed
below.

Figure 98 Quick Access Report List

ACTIVE LIST JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES
DEV EMPLOYEES REPORT
08/08/00 1
MGT EMPLOYEES REPORT
08/08/00 1
MGT BANKING REPORT
08/08/00 5
MKT EMPLOYEES REPORT
08/08/00 286
PROD INVENTORY REPORT
08/08/00 10
PROD EMPLOYEES REPORT
08/08/00 3
WAREHSE INVENTORY REPORT
08/08/00 1866
====== >>>>>>>>>>>>>>>>>> NO MORE REPORTS IN THE LIST <<<<<<<<<<<<<<<<<< ======

SELECT A REPORT BY FILLING Q IN THE OPTION FIELD

Press REFRESH (PF04/PF16) to redisplay the Quick Access Report list.

Press END (PF03/PF15) to exit to the previously displayed screen.

Type RETURN in the COMMAND field and press Enter to return to the User Reports
entry panel.

NOTE
To change the value in the BYPASS PANEL field of the User Reports entry panel, type
RETURN in the COMMAND field and press Enter to return to the User Reports entry panel
before exiting the User Reports facility.

226 CONTROL-D and CONTROL-V User Guide

 Quick Access Panels

Fields in the Quick Access Report List

Table 88 Fields in the Quick Access Report List

Field Description
USER Name of the report recipient as defined in the decollating mission.
REPORT Full name of the report as defined in the decollating mission.
ODATE Original scheduling date (date report was originally scheduled to be run).
PAGES Number of pages in the report.

Quick Access Report List Option

The Quick Access option (Option Q) enables you to display the Quick Access panels
of a report to retrieve and view report pages based on report index values.

NOTE
Only display type Q is available for the Quick Access Report list.

Quick Access Panels

Quick Access panels enable the user to display the index paths defined for a report
and to view or print report sections based on index and subindex values. Quick
Access panels are displayed by entering Q in the User Reports entry panel BYPASS
PANEL field or as an option in the Index window or the Active User Report list.

Chapter 2 Online Facilities 227

Quick Access Panels

Figure 99 Quick Access Panel

-------------------------- CONTROL-V QUICK ACCESS ---------------------(U.Q)
COMMAND ===> USER ===> N44

REPORT NAME: CENSUS RESIDENTIAL

JOB NAME: CENSUS5
DATE: 06/06/00
+--------------------------------------------------------------------------+
|INDEX VALUE |
| |
|CITY - JACKSONVILLE |
| |
|AREACOD - 32217 |
| |
|STREET - CASTELLON DR, N |
| |
|BLDG_NO - 2345 |
| |
|APT_NO - |
+--------------------------------------------------------------------------+

CMDS: END , ENTER , NEXT , PREV , PRINT , RETURN , SHPF 09.06.20

Each index path for a report is fully displayed in its own Quick Access panel. Use the
up and down or scrolling keys to display the next (PF08/PF11/PF20/PF23) or
previous (PF07/PF10/PF19/PF22) Quick Access panel.

If the same index exists in the next or previous panel, the value specified for that
index is retained when displaying the next or previous panel. If the same index does
not exist, its value is lost and must be specified again, if necessary, when a Quick
Access panel that does contain that index is displayed.

Values entered on a single Quick Access panel are used as selection criteria to select
report sections. If a value is not specified for a subindex, that subindex and all
subindexes below it (if any) are ignored. Report sections that are pointed to by the
index values specified on the Quick Access panel are retrieved. Each retrieved section
may be one or more pages depending on how the report was indexed. (Both
record-level and page-level index values retrieve report pages. However, report lines
are highlighted if they matched a record-level index value.)

If an asterisk, prefix or unmatched value is specified in an index value field, the

Values of Index panel is displayed with the available values for that index beginning
with the first value (if an asterisk is specified) or with the value that most nearly
matches the prefix or value specified.

228 CONTROL-D and CONTROL-V User Guide

 Quick Access Panels

Figure 100 Values of Index Panel

VALUES OF INDEX: CITY (U.Q.X)
COMMAND ===> SCROLL===> CRSR
O VALUE
BRUSSELS
BUENOS AIRES
CARACAS
DUSSELDORF
HONG KONG
ISTANBUL
LONDON
LOS ANGELES
MADRID
MILAN
PARIS
SEOUL
SINGAPORE
TOKYO
TORONTO
VIENNA
ZURICH
======== >>>>>>>>>>>>>>> NO MORE VALUES FOR THIS INDEX <<<<<<<<<<<<<<< ========

USE S TO SELECT A VALUE AND PRESS PF3 OR ENTER TO RETURN 10.03.39

Use option S (Select) in the Values of Index panel to select the desired value. Press
Enter to return to the Quick Access panel. The selected value is displayed in the Quick
Access panel value field for the appropriate index.

Fields of the Quick Access Panel

Table 89 Fields of the Quick Access Panel

Field Description
USER Name of the user assigned to the report.
REPORT NAME Name of the report.
JOB NAME Name of the job that produced the report.
DATE Original scheduling date of the report.
INDEX Dynamically generated index and subindex names.
VALUE Values specified by the user for the displayed indexes. Entering an
asterisk or prefix in this field causes the Values of Index panel for the
corresponding index to be displayed.

Chapter 2 Online Facilities 229

Quick Access Panels

\Commands of the Quick Access Panel

The following commands can be entered on the command line of the Quick Access
panel:

Table 90 Commands of the Quick Access Panel

Command Description
END Display the Quick Access panels for other specified reports, if any. Exit
the Quick Access panel and return to the previously displayed screen.
ENTER After specifying the desired values for the indexes whose names are
displayed, pressing Enter (with or without typing ENTER on the
command line) displays the report or report sections pointed to by
those index values.
NEXT Display the next Quick Access panel when more than one index path
satisfies the previously specified index name or mask criteria.
PREV Display the previous Quick Access panel when more than one index
path satisfies the previously specified index name or mask criteria.
PRINT After entering the desired values for the indexes whose names are
displayed, this command prints the report or report sections pointed to
by those index values.
RETURN Return to the User Reports entry panel.
SHPF Display a window defining the PFKeys described below.

PFKeys for the Quick Access Panel

Press PF24 in the Quick Access panel to display the available PFKeys:

Table 91 PFKeys for the Quick Access Panel

PFKey Description
PF01/PF13 Help.
PF03/PF15 Display the Quick Access panel for other reports, if any, then End.
PF04/PF16 Return to entry panel if BYPASS PANEL is set to Q and the Report list
was not displayed; otherwise, return to the previously displayed
screen.
PF06/PF18 =6.
PF07/PF19 Previous index path.
PF08/PF20 Next index path.
PF10/PF22 Previous index path.
PF11/PF23 Next index path.
PF24 Show PFKeys.

230 CONTROL-D and CONTROL-V User Guide

 Values of Index Panel

Values of Index Panel

The Values of Index panel lists all the values of a specified index. This panel enables
you to view or print report sections based on index values, to list the subindex names
that exist for an index value, or to select a value to be inserted in a Quick Access
panel.

The Values of Index panel is displayed when:

Option S is specified for an index in the Index window (described below)

Only one index would have been displayed in the Index window.
An asterisk, prefix or unmatched value is entered in a Quick Access panel value
field. The Values of Index panel lists values of the selected index in alphabetical
order.

If a value is specified in the User Reports entry panel, and the index does not contain
that value but does contain values that match it as a prefix, the Values of Index panel
is scrolled to the page that contains the matching values.

Figure 101 Values of Index Panel Example

VALUES OF INDEX: COUNTRIES (U.S.X)
COMMAND ===> SCROLL===> CRSR
O VALUE N # OF SECTIONS
ARGENTINA 00000001
AUSTRALIA 00000003
AUSTRIA 00000001
BELGIUM T 00000002
BRAZIL 00000002
CANADA 00000002
CHILE 00000001
COLUMBIA 00000001
DENMARK T 00000002
ECUADOR 00000001
EGYPT 00000001
FINLAND 00000001
FRANCE 00000003
GERMANY 00000002
GREECE 00000001
HONG KONG 00000001
INDIA 00000001
IRELAND 00000002
JAPAN 00000001

OPTIONS: V - VIEW P - PRINT X - SUBINDEXES 09.38.36

Use the scrolling conventions to scroll the Values of Index panel forward
(PF08/PF20) and backward (PF07/PF19).

Chapter 2 Online Facilities 231

Values of Index Panel

Fields of the Values of Index Panel

Table 92 Fields of the Values of Index Panel

Field Description
O (Option) Enter a 1-character option for: viewing or printing selected report
pages, displaying the Subindex window, or selecting a value for use in
the Quick Access panel. For more information see Options of the
Values of Index Panel
VALUE Value of the selected index.
N Note indicator. Indicates the type of notes, if any, attached to the
report:

blank No notes
G General note
T Tag notes
A Both General and Tag notes

For details about notes see Notepad Facility later in this chapter.
# OF SECTIONS Number of nonconsecutive report sections (RBA ranges) pointed to by
this index value. Consecutive report sections are combined and
counted as one section. Nonconsecutive pages in a single report
section are counted as separate sections.

Options of the Values of Index Panel

Table 93 Options of the Values of Index Panel

Option Description
V View the report pages pointed to by the selected index value.
P Display the Print Options window that enables you to print some or all
of the pages selected by an index value. For more information see
Printing Reports later in this chapter.
X Display the Subindex window. This window lists the available
subindexes (by subindex name, not value) that exist under the
specified value.
S Select one value for use in the Quick Access panel, then press Enter to
return to the Quick Access panel. The selected value is automatically
inserted in the appropriate value field in the Quick Access panel. This
option is only available when the Values of Index panel is displayed in
response to an asterisk, prefix or unmatched value specified in a value
field of the Quick Access panel.

232 CONTROL-D and CONTROL-V User Guide

 Index Window

FIND Command
The FIND command can be entered on the Command line of the Values of Index
panel. The cursor moves to the next location of the specified value if it exists on the
displayed screen and remains at its current location if the specified value is not visible
on the screen. For additional information, see Commands and PFKeys earlier in
this chapter.

LOCATE Command
The LOCATE command can be entered on the Command line of the Values of Index
panel. This command requires an index value or prefix (not masked) as a parameter.
If the specified value or prefix exists, the display of index values is scrolled to that
value or prefix. Otherwise, the display of index values is scrolled to the nearest index
value that does exist.

Index Window
This window is displayed when option X is specified for a report in the Active User
Report list.

The Index window enables a user to display the Values of Index panel or the Quick
Access Panel for a main index.

The Index window lists all main indexes of the report, indicates the media on which
each index currently resides, and indicates whether or not a copy of the index
remains on disk when the index migrates to another storage media.

All indexes defined in the reports decollating mission that satisfy the criteria
specified in the User Reports entry panel are listed in the Index window. To reduce
the time and effort required to access the desired section of a report, the Index
window is not displayed if only one index would be listed. Instead, the Values of
Index panel for that index is displayed.

Chapter 2 Online Facilities 233

Index Window

Figure 102 Index Window

ACTIVE LIST JOB REP REPORT40 USR <D> CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES LINES V N STATUS
MRKTG REPORT40
+-------------------------------------------------------+
X MRKTG | |
| MAIN INDEXES | d
====== >>> | REPORT REPORT43 | << ======
| |
| O INDEX MEDIA RESIDENT |
| SALES-REP CART Y |
| SALES-MGR CART Y |
| MKTG-AREA CART Y |
| ZIP-CODE CART N |
| PHONE-CODE CART N |
| |
| |
| |
| |
| USE S TO SELECT AN INDEX Q FOR QUICK ACCESS PANEL |
+-------------------------------------------------------+

P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT

X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 08.02.09

Use the PF03 or PF04 key to redisplay the previously displayed User Report list.

Fields of the Index Window

Table 94 Fields of the Index Window

Field Description
O(ption) Option field. For more information see Options of the Index
Window below.
INDEX Name of each report main index.
MEDIA Name of the media on which each index resides.
RESIDENT Indicates whether or not a copy of the index remains on disk when the
index migrates with the report to another storage media.

Y (Yes) A copy of the index (and its subindexes, if any) remains

disk-resident. Default, for the first three main indexes.

N (No) Index (and its subindexes, if any) can migrate to another

storage media. Default, for main indexes created after the first
three.

234 CONTROL-D and CONTROL-V User Guide

 Subindex Window

Options of the Index Window

Table 95 Options of the Index Window

Option Description
S (SELECT) Display the Values of Index panel that contains a sorted list of all the
values in the report for the selected main index.
Q (QUICK Display Quick Access panels that correspond to the specified report
ACCESS) and main index. These panels enable a user to directly view specific
pages and sections of the report by specifying a set of index values in
one of the panels.

Subindex Window
The Subindex window is displayed when option X is specified for a value in the
Values of Index panel. This window lists the names of subindexes that exist under
that index value.

Figure 103 Subindex Window

VALUES OF INDEX: COUNTRIES (U.S.X)
COMMAND ===> SCROLL===> CRSR
O VALUE N # OF SECTIONS
ARGENTINA 00000001
AUSTRALIA +------------------------------------------------------------+
AUSTRIA | |
BELGIUM | SUBINDEXES |
BRAZIL | VALUE CANADA |
X CANADA | |
CHILE | O INDEX |
COLUMBIA | STATE/PROVINCE |
DENMARK | CITY |
ECUADOR | ZIPCODE |
EGYPT | STREET |
FINLAND | BLDG_NO |
FRANCE | |
======== >>>>>> | |=
| |
| |
| USE S TO SELECT AN INDEX |
+------------------------------------------------------------+

OPTIONS: V - VIEW P - PRINT X - SUBINDEXES 11.23.09

Use option S to display a Values of Index panel listing values in the selected
subindex. Use the END command (PF03/PF15) to return to the previously displayed
Values of Index panel.

Chapter 2 Online Facilities 235

GIVETO Option Distributing Reports to Other Users

Fields of the Subindex Window

Table 96 Fields of the Subindex Window

Field Description
O Option field. For more information see Options of the Subindex
Window below.
INDEX Names of the available subindexes at the current level in the index
hierarchy.

Options of the Subindex Window

Table 97 Options of the Subindex Window

Field Description
S Display a Values of Index panel listing the available values in the
specified subindex

GIVETO Option Distributing Reports to Other Users

The G (GIVETO) option requests that a copy of a decollated report be provided to
another user. By default, only users in the Recipient Tree can be specified. However,
if the SUS2TRE Profile variable is set to N (No), the Recipient Tree is not checked for
the specified users.

This option opens the Give To window in the Report list.

NOTE
This option can only be specified for reports that have been decollated. Before the reports have
been decollated, copies of reports can be assigned to other users by specifying the user names
in the Additional Users field.

236 CONTROL-D and CONTROL-V User Guide

 GIVETO Option Distributing Reports to Other Users

Figure 104 GIVE TO Option Window

ACTIVE LIST <D> JOB REP USR CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES LINES V N STATUS
JONES REPORT7
08/0 +----------------------------+ ted
G ROBERT REP42 | CONFIRM : Y |
<----| GIVE TO USER : ACCTMGR |
ROBERT REP44 | INCLUDE NOTES : Y |
T 08/0 +----------------------------+
ACTG02 INVTORY
08/08/00 4 4 V Decollated
====== >>>>>>>>>>>>>>>>>> NO MORE REPORTS IN THE LIST <<<<<<<<<<<<<<<<<< ======

V VIEW E EDIT P PRINT U UPDT I INS D DEL N NOTE A ADD INFO G GIVETO 13.16.13

The Give To window enables you to specify who is to receive a copy of the report and
whether or not notes are to be included with the copy of the report.

The following values can be specified:

Table 98 GIVE TO Option Window Fields

Field Description
CONFIRM Valid values:

Y (Yes) Confirms the Give To request.

N (No) No action is taken. If N is specified, the other two fields in
the window are ignored.
GIVE TO USER Specify the name of the user who should receive a copy. Only user
names in the Recipient Tree can be specified.
INCLUDE NOTES Indicate whether or not notes are included with the copy of the report.

Y (Yes) Notes belonging to the report are also copied.

N (No) Notes are not copied.

Pressing the REFRESH key (PF04/PF16) adds to the Report list the copies given to
other users. The name of the user that provided the report is displayed in the
FROMUSER field of the User Report List screen.

Copies of reports provided by the G (Give To) option have a status of Decollated.
They can be printed by entering option P (Print), or viewed by specifying option V
(View).

Chapter 2 Online Facilities 237

Printing Reports

Printing Reports
Option P opens the Print Option window that enables you to request Immediate
Printing or special cases of Deferred Printing. It is used to print reports that are not
scheduled for printing or to request additional printouts of reports which are
scheduled for printing or which have already printed.

Figure 105 Print Option Window

ACTIVE LIST <D> JOB REP USR ACTG CHILD (U)
COMMAND ===> +----------------------------------------------------------+
O USER REPOR | |
JOHN TEST1 | PRINT OPTION ===> |
| |
MATHEW REPOR | 1 Immediate Printing |
| 2 Deferred Printing (by Print Mission) |
PETER REPOR | X Exit (no action) |
| |
P ROBERTS REP43 | COPIES 001 FORM STD CLASS S |
| |
SMITHA TEST1 | DEST WTR |
| |
THOMAS TEST3 | FROM PAGE 000001 TO PAGE 000042 RULER DEFAULT |
====== >>>>>>>>> | |
| PRINT MISSIONS STDPRNT |
| |
| PAGEDEF FORMDEF |
| |
| REPORT REP43 |
| USER ROBERTS JOB M83REPM |
| |
+----------------------------------------------------------+
V VIEW E EDIT P PRINT U UPDT I INS D DEL N NOTE A ADD INFO G GIVETO 13.16.13

If a single index and an exact index value were specified, report sections for that
index value are printed. Otherwise, the entire report is printed.

You can choose one of three options on the Print Option window:

Table 99 Print Option Window Fields

Field Description
1 Immediate Printing. The report is sent to the printer specified in the DEST field
immediately.
2 Deferred Printing. The report is printed later with other reports that are
received in your bundle. The status of the report entry changes to WAIT
PRINT.
X Take no action. Exit the Print Option window.

238 CONTROL-D and CONTROL-V User Guide

 Printing Reports

NOTE
Option 1 is usually used to print on a remote printer which is located near the user. Option 2 is
usually used when the user does not have a remote printer and wants to add a copy of a
report to the next regular bundle. Option 2 is not available for migrated reports or for reports
retrieved using specific index values.

The following parameters can be modified in the Print Option window:

Table 100 Print Option Window Parameters (part 1 of 2)

Parameter Description
COPIES Number of copies to print. This number cannot be greater than the
maximum defined for this report in the decollating parameters.
FORM Form to use when printing the report.
CLASS Output class in which the report should be printed.
DEST Remote destination (node and user ID) where the report should be
printed (or blank for the default printer). If the Optional Wish WD1458
is set to APPLY=YES, the node value can be set to LOCAL to print the
report on the printer whose designation is LOCAL.

If the node value is set to FILE, the report is printed to the file
referenced by DD statement CTDOUT1.

If CONTROL-D for Distributed Systems is installed, reports can be

distributed to a Unix or Windows NT environment by setting the node
value to CTDS. For details see CONTROL-D for Distributed Systems
on page 286.
WTR Use this field to specify the name of an external writer on which the
report should be printed. (If your data center is using TS-PRINT, this
field usually designates the VTAM name of the printer.)
FROM PAGE TO Enables you to print a range of pages from a retrieved report. If the
PAGE entire report has been retrieved, the value displayed in TO PAGE is the
number of pages in the entire report. If only a section of a report has
been retrieved, these parameters are blank.

If the entire report has been retrieved, specify the desired page range
using actual report page numbers. If only a section of a report has been
retrieved via an index, specify the desired page range using page
numbers relative to the beginning of the retrieved section.

For example, if the report section retrieved is pages 46 through 55 from

a 100-page report and you want to print the pages numbered 49-52 in
the report, enter FROM PAGE 000004 TO PAGE 000007.

Chapter 2 Online Facilities 239

Restoring Reports

Table 100 Print Option Window Parameters (part 2 of 2)

Parameter Description
RULER For Immediate Printing, you can use any ruler name or print without a
ruler (as is). For Deferred Printing, the default print ruler is used if it
exists; otherwise, no ruler is used.
PRINT MISSIONS List of printing missions by which this report can be printed is
displayed (0 to 4 names). Even if more than one printing mission name
is specified, a report is printed only once by the specified printing
mission which is activated first. Printing mission names should be
significant to the user. For example, the name may represent the paper
type (STD) or the time of printing (NIGHT). When you use Print
Option 2 (Deferred Printing), at least one printing mission name must
be supplied. Be sure to use a name which is valid at your site. If you
use Print Option 1 (Immediate Printing), the content of this field is not
relevant and can remain unchanged.

Restoring Reports
Option R is used in the User History Report list or the User Active/Migrated report
list for Migrated reports to request that a report be restored from cartridge, tape, or
OAM collection to disk. This option opens the Restore window in the Report List
screen.

Figure 106 Restore Window

HISTORY LIST <D> JOB REP USR MGT CHILD (U)
COMMAND ===> SCROLL===> CRSR
O USER REPORT ODATE PAGES LINES STATUS
MGT BANKING REPORT +-------------------------------+
| CONFIRM : |
R MKT EMPLOYEES REPORT <-----| BY RESTORE MISSION: RST0060M |
+-------------------------------+
PROD INVENTORY REPORT
08/08/00 8 369 Backed up
PROD EMPLOYEES REPORT 08/08/00 3 169 Backed up
08/08/00 1254 51492 Backed up
WAREHSE INVENTORY REPORT
08/08/00 1866 80238 Backed up
====== >>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<< ======

OPTIONS: R RESTORE C NO-RESTORE U UPDATE D DELETE A ADD INFO 11.02.43

The Restore window contains the name of the default restore mission. You can do any
of the following:

240 CONTROL-D and CONTROL-V User Guide

 Notepad Facility

Type Y (Yes) to confirm the restore request.

Change the mission name (it is recommended that you consult with your
INCONTROL administrator before doing so).

Type N (No) and press Enter if you decide not to restore.

Restore requests are processed according to site-defined restore schedules and not
immediately. When a restore request is entered, the request is recorded and the
report status changes to WAIT RESTORE. When the restore is completed, the sysout
is on disk and the restored entry appears on both the Active and History lists with a
status of Restored.

Canceling a Restore Request

Option C is used to cancel a restore request that has already been entered but not yet
processed.

Notepad Facility
The Notepad facility enables the user to append notes to reports. A note can be read,
modified or deleted using the Note window. Depending on the site security
mechanism, other users may or may not access these notes for viewing and/or
modification.

Notes appended to a report migrate with the report. Notes can be appended to a
migrated report.

Notes appended to a report are backed up with the report to the History User Report
file. These notes are restored with the report when it is restored to the Active User
Report file. Notes are kept on the mainframe and are accessible via the CONTROL-V
Online Interface and CONTROL-D/WebAccess Server using CONTROL-D/Page On
Demand.

Two types of notes can be defined:

Table 101 Notepad Facility Note Types

Type Description
General notes General notes can be attached to reports in the Active Report List
screen, one note to a report. The General Note window for a report can
be opened by entering option N (Note) for the report.
Tag notes Tag notes can be attached to specific substrings of a report in the
Report Viewing screen. The method of opening Tag notes is described
later in this chapter.

Chapter 2 Online Facilities 241

Notepad Facility

In the Default (D) display type of the Active Report list, the existence of report notes
is indicated in the N (Note) field as follows:

Table 102 N (Note) Field Values

Value Description
blank The report does not contain a note.
G The report contains a General note.
T The report contains at least one Tag note.
A (All.) The report contains both General and Tag notes.

Multiple Versions
Both general notes and tag notes can have multiple versions. For more information
about tag notes, see Tag Notes later in this chapter.

When a Note window is opened and a note exists, the last version is displayed in
Browse mode. At this point, the user can do any of the following:

Produce a new version of the note in Edit mode by pressing the NEW key
(PF04/PF16). The version number of the new note is one higher than the last
existing version number.

Display the previous or next version of the note in Browse mode by pressing the
PREV key (PF10/PF22) or NEXT key (PF11/PF23).

Change the mode of the currently displayed note to Edit by pressing the UPDATE
key (PF06/PF18).

When a note is in Edit mode, the user can edit or modify the note and/or perform the
following actions:

Clear the contents of the Note window by pressing the CLEAR key (PF07/PF19).

Save a new or changed version of the note by pressing the SAVE key (PF05/PF17).

Delete the displayed version of the note by pressing the DELETE key (PF08PF20).

Display the previous or next version of the note in Browse mode by pressing the
PREV key (PF10/PF22) or NEXT key (PF11/PF23).

To exit the Note window, press the END key (PF03/PF15).

A confirmation window is displayed when saving or deleting a note, or when

scrolling from a new or changed version of a note to the next or previous version.

242 CONTROL-D and CONTROL-V User Guide

 Notepad Facility

When a version of a note is deleted, the version numbers of the remaining notes are
not changed. The next version of the note (if any) is displayed in Browse mode. If the
latest version of a note is deleted, the last previous version (if any) is displayed in
Browse mode.

NOTE
The user exit can be modified to prevent changes and deletions to existing note versions.

General Note Window

The General Note window is displayed when N is specified in the OPTION field of
the Active User Report list. If a Note window is opened for an existing (previously
created) note, the window is opened in Browse mode.

For information about the Tag Note Window, see Tag Notes later in this chapter.

Figure 107 General Note Window Browse Mode

ACTIVE LIST <D> JOB REP USR CHILD (U)
COMMAND ===> +---------------------NOTE PAD FACILITY----------(GENERAL)-+
O USER REPORT | BROWSE VERSION 0001 N44 07/07/00 17:01:33|
WAREHSE MAINT | JOHN, |
WAREHSE SHORTG | COMPARE THIS HALF-YEAR INVENTORY WITH THE END-OF-YEAR |
WAREHSE ONORDR | INVENTORY TO DETERMINE IF ANY HIGH VOLUME ITEMS ARE |
WAREHSE INSTCK | UNDERSTOCKED. |
WAREHSE 3RDQTR | |
WAREHSE 4THQTR | |
WAREHSE 1STQTR | |
N WAREHSE 2NDQTR | |
WAREHSE INVENT | |
WAREHSE INVENT | |
WAREHSE ORDERS | F3:END F6:UPDATE |
WAREHSE ORDERS +----F4:NEW---------------F10:PREV-------------F11:NEXT----+
DEVEL REP-JCLARC-PROD 04/07/00 34 1376 V Decollated
DEVEL JCLARC-PROD 04/07/00 34 1376 Decollated
DEVEL JCLARC-PROD 04/07/00 22 890 Decollated
DEVEL NEW NIGHT REPORT 05/07/00 5 10 V T Decollated
DEVEL NEW DAY REPORT 05/07/00 3 6 Decollated
DEVEL NIGHT REPORT ONE IND 05/07/00 5 10 Decollated

P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT

X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 17.00.41

The bolded USER ID above indicates the user ID of the user that created or last
updated the note. The bolded date and time above indicates the date and time the
note was created or last updated.

Chapter 2 Online Facilities 243

Notepad Facility

Note Window Commands

The commands available in a particular mode (Browse or Edit) are listed at the
bottom of the Note window. All commands, and the PFKeys that implement them,
are listed below:

Table 103 Note Window Commands

Command PFKey Description
END PF03/PF15 Close the window when you finish creating, viewing,
modifying, or deleting a note. A confirmation window
may be displayed.
NEW PF04/PF16 Add a new version of an existing note. An empty Note
Window is displayed.
SAVE PF05/PF17 Save or create the note version that is currently being
edited. A confirmation window is displayed.
UPDATE PF06/PF18 Place a Browse mode window in Edit mode to modify an
existing note.
CLEAR PF07/PF19 Erase the contents of the current window.
DELETE PF08/PF20 Delete the current version of a note. A confirmation
window is displayed.
PREV PF10/PF22 Scroll back to the previous version of a note. Display it in
Browse mode.
NEXT PF11/PF23 Scroll forward to the next version of a note. Display it in
Browse mode.

When a new Note window is opened, or when PF06/PF18 is pressed in an existing

Note window, the window is displayed in Edit mode.

244 CONTROL-D and CONTROL-V User Guide

 Notepad Facility

Figure 108 General Note Window Edit Mode

ACTIVE LIST <D> JOB REP USR CHILD (U)
COMMAND ===> +---------------------NOTE PAD FACILITY----------(GENERAL)-+
O USER REPORT | EDIT VERSION 0001 M83B 07/07/00 14:08:38 |
DEVEL TEST-B | JOHN, |
WAREHSE E-O-YR | COMPARE THIS HALF-YEAR INVENTORY WITH THE END-OF-YEAR |
WAREHSE INVENT | INVENTORY TO DETERMINE IF ANY HIGH VOLUME ITEMS ARE |
WAREHSE 1STQTR | UNDERSTOCKED. |
N WAREHSE 2NDQTR | |
WAREHSE ON_ORD | |
WAREHSE BCKORD | |
WAREHSE DAMAGE | |
ACTG JAN | |
ACTG FEB | |
ACTG MAR | F3:END F7:CLEAR F8:DELETE |
ACTG APR +----F5:SAVE--------------F10:PREV-------------F11:NEXT----+
ACTG MAY 06/01/00 116 7308 0 Decollated
ACTG JUN 07/07/00 137 8631 * Decollated
PROD 0001 02/10/00 107 6741 8 Decollated
PROD 0002 03/10/00 102 6426 1 Decollated
PROD 0003 04/10/00 150 9450 5 Decollated
PROD 0004 05/10/00 96 6048 1 Decollated
P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT
X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 13.14.57

Type information in the window in free text format.

To erase existing text in a Note window, press PF07/PF19.

Press PF08/PF20 to delete the note. Confirmation is required to delete a previously

created note.

Enter Y (Yes) to delete the note.

Enter N (No) to close the Note window without deleting the note.

Exiting a Note Window

Press PF03/PF15 to exit a Note window. Confirmation may be required to close the
window.

The Note window is closed without confirmation in the following situations:

The window is empty and the note is a new note (the note is not created).
No changes have been made to a previously existing note (the note is kept).

Otherwise, confirmation is requested as follows:

CREATE confirmation is requested for a new note.

SAVE confirmation is requested for a non-empty, previously existing note.
DELETE confirmation is requested for a previously existing note.

Chapter 2 Online Facilities 245

Report Viewing

Figure 109 General Note Window Exit Command

ACTIVE LIST <D> JOB REP USR CHILD (U)
COMMAND ===> +---------------------NOTE PAD FACILITY----------(GENERAL)-+
O USER REPORT | EDIT VERSION 0001 N44 07/07/00 11:00:52 |
DEVEL TEST-B | JOHN, |
WAREHSE E-O-YR | COMPARE THIS HALF-YEAR INVENTORY WITH THE END-OF-YEAR |
WAREHSE INVENT | INVE +--------------------------------------------+ |
WAREHSE 1STQTR | UNDE | PLEASE SELECT EXIT OPTION | |
N WAREHSE 2NDQTR | | | |
WAREHSE ON_ORD | | SAVE Y (Y/N) | |
WAREHSE BCKORD | +--------------------------------------------+ |
WAREHSE DAMAGE | |
ACTG JAN | |
ACTG FEB | |
ACTG MAR | F3:END F7:CLEAR F8:DELETE |
ACTG APR +----F5:SAVE--------------F10:PREV-------------F11:NEXT----+
ACTG MAY 06/07/00 116 7308 0 Decollated
ACTG JUN 07/07/00 137 8631 * Decollated
ACTG JUL 07/07/00 103 6489 6 Decollated
PROD 0001 02/07/00 107 6741 8 Decollated
PROD 0002 03/07/00 102 6426 1 Decollated
PROD 0003 04/07/00 150 9450 5 Decollated
PROD 0004 05/08/00 96 6048 1 Decollated
P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT
X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 13.14.57

Enter Y (Yes) to create, save, or delete the note as requested in the confirmation
prompt.

Enter N (No) to close the window without saving any changes.

Report Viewing
The V (View) option is used to display reports online in the Report Viewing screen.

When option V is specified in an Active User Report list whose selection criteria did
not include a specific index with a specific value (or value prefix matched by a unique
value), the Report Viewing screen displays the whole report.

When option V is specified in a Values of Index panel, in an Active User Report list
whose selection criteria included a specific index with an existing value, or in a Quick
Access panel, the Report Viewing screen displays the first report page that is pointed
to by the specified index value. The section retrieved may consist of one page or
many pages depending on how the report was indexed.

246 CONTROL-D and CONTROL-V User Guide

 Report Viewing

Figure 110 Report Viewing Screen

------------- CONTROL-D/V REPORT VIEWING NOTES 2 PAGE 1 OF 10
COMMAND ===> SCROLL ===> CRSR
USER PROD JOBNAME M83REPM JOBNUMB 0010022 DATA 080800 RULER
REPORT EMPLOYEES REPORT
----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----8
E M P L O Y E E S R E P O R T ----- FOR PRODUCTION DEPAR
EMPLOYEE EMPLOYEE OFFICE ANNUAL SOCIAL NO. OF JOB CLASS
NO. NAME NO. SAL SECURITY NO. DEPENDENTS CODE
-------- -------------- ------ ------ ------------ ---------- ---------
66474 C. POHLHAMMER 23 39,500 831-62-8752 2
66475 G. MEREDITH 09 40,000 125-22-2235 3
66491 P. MILLER 12 31,500 585-47-2352 1
66498 K. BOYLE 22 39,500 832-52-5455 2
66501 R. BERLE 14 39,500 834-02-3361 2
66513 C. KING 12 30,000 988-02-8475 2
66519 G. BROWNE 02 36,500 748-38-2884 2
66524 R. SOLOMON 04 35,000 960-52-2350 3
66526 S. CUNNINGHAM 21 39,500 834-01-2852 2
66529 M. TABER 22 39,500 823-00-2352 2
66530 A. WINGER 23 39,500 823-44-5858 2
66531 B. BOOKSPAN 05 47,000 315-42-2358 4
66533 R. MULU 29 39,500 821-22-5850 2
66539 E. SMART 02 29,000 681-35-3126 4
66540 N. MATTOZZI 11 29,000 525-42-2845 2
CMDS: FIND str (PREV), EDIT, RULER on/off/name, VALUE, N n P p 14.48.10

NOTE
Default color definitions for the Report Viewing screen are specified in the User profile. To
change these definitions, see your INCONTROL administrator. You can use rulers (described
later in this chapter) to override default color definitions.

Viewing Migrated Reports

When viewing reports that have migrated to optical disk or cartridge, the user
receives a message indicating that data retrieval is in progress.

Users accessing IOA via the TSO or ISPF interface receive the following message:

Data is being retrieved

from external storage
Please wait

Users accessing IOA via other interfaces using IOA Online monitor services receive
the following message:

Data is being retrieved

from external storage
Please press ENTER and wait

IOA Online monitor users should press Enter each time this message is displayed.

Chapter 2 Online Facilities 247

Report Viewing

Header Fields in the Report Viewing Screen

The following fields are displayed in the Report Viewing screen header:

Table 104 Header Fields in the Report Viewing Screen

Field Description
NOTES Total number of notes appended to the report.
USER User name of the report recipient.
REPORT Name of the report.
JOBNAME Name of the job that produced the report.
JOBNUMB Number of the job that produced the report.
DATA ODATE (original scheduling date) of the report.
RULER Name of the current ruler (if any) for the report.
PAGE m OF n Number of current page displayed and the number of pages in the
report (if an entire report was retrieved).

Report Viewing Screen Commands

General Commands

Use the scrolling conventions to scroll the retrieved section of the report forward
(PF08/PF20) or backward (PF07/PF19).

Use the LEFT (PF10/PF22) and RIGHT (PF11/PF23) commands to shift the report
data horizontally.

Use the FIND (or FIND PREV) command to locate a string in the report.

Use the NEXTPAGE n command (abbreviated N n) to scroll forward n report pages.

The top of the page is displayed. If n is not specified, the report scrolls forward one
page.

Use the PREVPAGE n command (abbreviated P p) to scroll backward p report pages.

The top of the page is displayed. If p is not specified, the report scrolls backward one
page.

Use the END command (PF03/PF15) to exit the Report Viewing screen and return to
the previously displayed screen.

248 CONTROL-D and CONTROL-V User Guide

 Report Viewing

Use the =X command to exit the Report Viewing screen and the entire Online User
Reports facility. You are then returned to your normal operating environment.

Table 105 Report Viewing Screen Commands (part 1 of 2)

Commands Description
SHOWPAGE The SHOWPAGE command alternately turns Show Page Control
Characters mode on and off. When the mode is off, page control
characters are not displayed. When the mode is on, lines starting with
control characters X8B and X89 are displayed.

When the mode is on, a special line appears at the beginning of each
page:

=== NEW PAGE ===

This line designates where CONTROL-V positions the beginning of

the page (for example, control character 1). The line is internally
generated and is not printed. It is very useful, particularly for reports
that do not contain page control characters.

Show Page mode can be turned on when a ruler is not active. When a
ruler is turned on, Show Page mode is turned off.
SPAGE When a complete report has been retrieved, the SPAGE (Select Pages)
command enables the user to specify one or more report pages or page
ranges for immediate printing. For more information on using the
SPAGE command, refer to Selecting Report Pages for Printing later
in this chapter.
SHOWCC The SHOWCC command alternately turns Show Control Characters
mode on and off. When the mode is turned on and the leftmost
portion of the report is visible on the screen, column 1 of the report,
which contains control characters, is displayed. When the mode is
turned off, the report is shifted one character to the left and the control
characters are hidden.

The mode in use upon entering the Report Viewing screen is

determined by the value (Y/N) of the SHOW CONTROL CHARS
field in the Show Options window.
EDIT The EDIT command (PF04/PF16) allows you to edit (reformat) reports
by use of rulers. Report editing and rulers are discussed later in this
chapter.
VALUE The VALUE command displays the index value (if any) that was used
to select the displayed report. This index value is displayed instead of
the ruler line. Pressing Enter clears the index value and displays the
ruler line again.
HEX The HEX command alternately turns HEX mode on and off. When
HEX mode is on, each line is displayed in HEX format. This command
is not available when a page mode ruler is active. For more
information see Page Mode Rulers later in this chapter.

Chapter 2 Online Facilities 249

Report Viewing

Table 105 Report Viewing Screen Commands (part 2 of 2)

Commands Description
LOCVAL The LOCVAL command locates the next occurrence of a report line
that contains a specified record-level index value. This command
moves the cursor to the next line pointed to by the specified value and
scrolls that line to the top of the viewing area. To use this command,
type LOCVAL on the command line and press Enter, or press the
PF09 key.

This command is only available when a report is viewed via the

Values of Index Panel. Display the appropriate record-level index in
the Values of Index Panel and use option V to select the value that
points to the report lines you want to display.

The LOCVAL command can be automatically executed when a report

is displayed. Set profile variable SOLVLVC in member $PROFVAR of
the IOA PARM library to Y (Yes). The report automatically scrolls to
the first line pointed to by the selected record-level index value.
WRAP The WRAP command alternately turns WRAP mode on and off. When
WRAP mode is on, data is wrapped to the next line of the screen, as
needed, according to length of the data and the width of the screen.
When WRAP mode is off, up to 256 characters in a line can be
displayed by scrolling past the edge of the screen. Remaining data
past 256 characters is not displayed.

This command is available only when SHOWCC/SHOWPAGE mode

is on. It is not available when a ruler is active.
Note: Even when WRAP mode is on, Tag Notes cannot be attached to
a substring past the 256th character in a line. For more information on
Tag Notes, see Tag Notes below.

Selecting Report Pages for Printing

When a complete report has been retrieved, the SPAGE (Select Pages) command
enables the user to specify one or more report pages or page ranges for immediate
printing from the Report Viewing screen. (By default, PF12/PF24 is defined as the
SPAGE command in the Report Viewing screen.)

Enter command SPAGE in the command line (or press PF12/PF24) once for each
page or page range to be included (or excluded from an otherwise included page
range). Upon pressing END (PF03/PF15), the Selected Pages Print Option Window
(described below) is displayed.

Any number of SPAGE commands can be entered, with the first parameter set to
INCLUDE or EXCLUDE in any order. EXCLUDE ranges are excluded from the
INCLUDE ranges. If only EXCLUDE ranges are specified, the Selected Pages Print
Option window is not displayed and no pages are printed.

250 CONTROL-D and CONTROL-V User Guide

 Report Viewing

NOTE
Command SPAGE is not currently supported when viewing reports retrieved using an index
value.

SPAGE Format

SPAGE INCLUDE|EXCLUDE FROM-PAGE TO-PAGE

SPAGE RESET

where:

INCLUDE|EXCLUDE determines whether pages specified by the page range are

included in or excluded from the immediate printing of the report. INCLUDE and
EXCLUDE can be abbreviated as I and E. If neither INCLUDE nor EXCLUDE is
specified, the default is INCLUDE. Any page specified in both an include and an
exclude range is excluded and not printed.

FROM-PAGE is the lowest page number in a range specified for inclusion or

exclusion. A number from 1 to the report sections last page number can be
specified. The number specified must not be greater than TO-PAGE.

If an asterisk (*) or blank is specified, FROM-PAGE is set to the page number

associated with the current screens top report line. If only FROM-PAGE is
specified, that one page is selected for printing. If neither FROM-PAGE nor
TO-PAGE is specified, the page number associated with the current screens top
report line is selected for printing.

TO-PAGE is the highest page number in a range specified for inclusion or

exclusion. A number from the value of FROM-PAGE to the report sections last
page number can be specified. If a higher number is specified, it is automatically
changed to the report sections last page number.

TO-PAGE can be specified as +n, where n is a number from 1 to 99999999, to

produce a range that includes the FROM-PAGE plus the following n pages. If an
asterisk (*) is specified, TO-PAGE is set to the page number associated with the
current screen report line. If TO-PAGE is not specified, the default is the value of
FROM-PAGE.

RESET cancels all previously specified page ranges. RESET can be abbreviated as
R.

Chapter 2 Online Facilities 251

Report Viewing

Selected Pages Print Option Window

If any valid SPAGE commands were entered while viewing a report, the Selected
Pages Print Option window is displayed when the END command (PF03/PF15) is
used to return to the User Report List screen. This window allows the user to
immediately print the selected pages.

Figure 111 Selected Pages Print Option Window

ACTIVE LIST JOB REP USR CHILD (U)
COMMAND ===> +----------------------------------------------------------+
O USER REPOR | |
ACCTG DAYRE | Selected pages print option ===> |
ACCTG DAYRE | |
V ACCTG REPOR | 1 Immediate Printing |
ADMIN REPOR | X Exit (no action) |
ADMIN REPOR | |
ADMIN REPOR | COPIES 001 FORM STD CLASS X |
ADMIN REPOR | |
MFG REPOR | DEST WTR RULER DEFAULT |
MFG INVEN | |
MFG INVEN | PAGEDEF FORMDEF |
MFG ONORD | |
MFG ONORD | REPORT REPORTW |
MFG ONORD | USER ACCTG JOB TAXEST |
MKT REGIO +----------------------------------------------------------+
MKT REGION2 08/08/00 87 212 V Wait print
MKT REGION3 08/08/00 25 919 Wait print
MKT REGION4 08/08/00 87 212 V Wait print
MKT REGION6 08/08/00 25 919 Wait print

V VIEW E EDIT P PRINT U UPDT I INS D DEL N NOTE A ADD INFO G GIVETO 13.16.13

The following parameters can be modified in the Selected Pages Print Option
window: COPIES, FORM, CLASS, DEST, WTR and RULER. These parameters are
documented in the description of the Print Option window in Printing Reports
earlier in this chapter.

You can choose one of two options on the Selected Pages Print Option window:

1 Immediate Printing. The report is sent to the printer specified in the DEST field
immediately.
X Take no action. Exit the window.

252 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

Editing (Reformatting) Reports

Rulers
A ruler is a set of screen editing rules that can be used to make an existing report look
different on the screen. Rulers are report specific. You can define any number of
rulers for any report.

Report Editing (Ruler) Screen

Entering the EDIT command (PF04/PF16) in the Report Viewing screen or specifying
option E for any entry except for a global ruler entry that is not associated with a
specific report in the Active User Report List screen displays the Report Editing
(Ruler) screen. This screen allows you to specify ruler selection criteria. Select the
desired option (1, 2, 3 or 4), fill in the selection criteria, and press Enter.

Figure 112 Report Editing (Ruler) Screen

------------------------ CONTROL-D - REPORT EDITING --------------------(U.E)
COMMAND/OPT ===>
USER PROD REPORT EMPLOYEES REPORT JOB PREMPRS2
RULER NAME ===> DEFAULT Name or blank for default ruler
RULER TYPE ===> VIEW View or Print
REPORT NAME ===> To copy a ruler - full report name
JOB NAME ===> To copy a ruler - full job name
USER NAME ===> To copy a ruler - full user name
1 EDIT report lines and columns
2 INCLUDE lines based on strings
3 EXCLUDE lines based on strings
4 COLOR lines based on strings
PLEASE SELECT OPTION, OR PRESS PF3 TO SAVE/EXIT THE RULER 11.58.26

Figure 113 Ruler Selection Fields

RULER NAME ===> JCLSCAN Name or blank for default ruler
RULER TYPE ===> VIEW View or Print
REPORT NAME ===> JCL-MSG To copy a ruler - full report name
JOB NAME ===> D4X0030 To copy a ruler - full job name
USER NAME ===> To copy a ruler - full user name

The selection criteria that can be applied are:

Table 106 Report Editing (Ruler) Screen Selection Criteria (part 1 of 2)

Criteria Description
RULER NAME Ruler name. Each edit format (ruler) has its own name. You can define
different rulers for the same report and use them according to your
requirements. If the ruler name is omitted, a search is made for the
name DEFAULT (that is, the default ruler).
RULER TYPE Edit options can be applied either for report viewing (VIEW) or for
printing (PRINT).

Chapter 2 Online Facilities 253

Editing (Reformatting) Reports

Table 106 Report Editing (Ruler) Screen Selection Criteria (part 2 of 2)

Criteria Description
REPORT NAME Name of a report from which to copy the ruler.
JOB NAME Name of the job from which to copy the ruler.
USER NAME Name of a user from which to copy the ruler.

The report name, job name and user name should be filled in when you want to copy
a previously defined ruler that is not defined for the report, job, or user. For example,
to copy a ruler named JCLSCAN which you have already defined for report name
JCL-MSG and job D4X0030, use the data in the screen segment above.

You do not have to fill in the user name. The user ID of the current entry is assumed.
Whenever the report name, job name or user name is omitted, the values of the
current entry are assumed.

Ruler Edit Options

Below is a brief description of the four types of ruler edits that can be performed. An
in-depth explanation of these ruler edits follows the brief description.

1. Edit Lines and Columns

This option allows you to:

Define header and footer lines that remain on the screen as you scroll through
the report.

Insert overlay lines to make the report more readable or to condense header
information.

Delete unwanted lines, including unnecessary header lines.

Establish Dynamic Extraction parameters to condense and relocate dynamically

changing header information.

Reformat columns so that fields can be relocated in your report. You can omit
undesired fields and you can repeat fields.

Freeze columns so they do not move when you shift your display left and right.

Define colors within your online report display.

2. Include Lines Based on Strings

254 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

The Include option allows you to select report lines for inclusion in the report
based on the appearance of a strings in specified column locations. Report lines not
conforming to the specified string criteria are not included in the report display (or
printout). This option allows you to:

Limit the string selection to specified line ranges.

Specify color for lines included in the report.

3. Exclude Lines Based on Strings

The Exclude option allows you to select report lines for exclusion from the report
based on the appearance of a strings in specified column locations. Report lines
conforming to the specified string criteria are not included in the report display (or
printout). This option allows you to:

Limit the string selection to specified line ranges.

4. Color Lines Based on Strings

The Color option allows you to define colors for your report, based on strings that
appear in the report in specified lines and columns.

Edit Lines and Columns

When you enter option 1 (Edit Lines and Columns) on the Report Editing (Ruler)
screen, the screen Figure 114 is displayed.

Figure 114 Edit Lines and Columns on the Report Editing (Ruler) Screen
----------------- CONTROL-D - EDIT REPORT LINES AND COLUMNS ----------(U.E.1)
COMMAND ===> SP CHAR SCROLL===> CRSR
USR PROD REP EMPLOYEES REPORT JB PREMPRS2 RULER DEFAULT TYPE VIEW
O ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+-
1 E M P L O Y E E S R E P O R T ----- FOR PRODUCTION DE
EMPLOYEE EMPLOYEE OFFICE ANNUAL SOCIAL NO. OF JOB CLAS
NO. NAME NO. SAL SECURITY NO. DEPENDENTS CODE
-------- -------------- ------ ------ ------------ ---------- --------
66474 C. POHLHAMMER 23 39,500 831-62-8752 2
66475 G. MEREDITH 09 40,000 125-22-2235 3
66491 P. MILLER 12 31,500 585-47-2352 1
66498 K. BOYLE 22 39,500 832-52-5455 2
66501 R. BERLE 14 39,500 834-02-3361 2
66513 C. KING 12 30,000 988-02-8475 2
66519 G. BROWNE 02 36,500 748-38-2884 2
66524 R. SOLOMON 04 35,000 960-52-2350 3
66526 S. CUNNINGHAM 21 39,500 834-01-2852 2
66529 M. TABER 22 39,500 823-00-2352 2
66530 A. WINGER 23 39,500 823-44-5858 2
66531 B. BOOKSPAN 05 47,000 315-42-2358 4
66533 R. MULU 29 39,500 821-22-5850 2
66539 E. SMART 02 29,000 681-35-3126 4
66540 N. MATTOZZI 11 29,000 525-42-2845 2
OPTIONS: H HEADER F FOOTER D DELETE C COLUMNS I INSERT B BEFORE 11.59.53

Chapter 2 Online Facilities 255

Editing (Reformatting) Reports

The screen contains one page of the report. This sample page is used to define the line
and column editing criteria. You can use the scrolling conventions to scroll backward,
forward, left and right on the page. If you enter this screen from the Active Report
list, the first page of the report is displayed. If you enter this screen from the Report
Viewing screen, the currently viewed page is displayed.

Each data line of the page is preceded by an option field. Valid options:

Table 107 Options for Edit Lines on the Report Editing (Ruler) Screen
Option Description
H (HEADER) This line of the report page is fixed as a header when scrolling.
Normally, because of the difference between the number of lines in a
report page and in a screen, the header of the report disappears when
you scroll forward on a page. Lines marked as HEADER remain at the
top of the screen when you scroll the report. When the beginning of the
next report page is reached, the header of that report page becomes the
header on the screen.

Any number of lines can be marked as headers. Multiple header lines

must be contiguous (except for lines marked D for Delete) and begin
with the first line on the page.
F (FOOTER) Similar to header line definition, footers begin at the bottom line of the
report page. In all other respects, they operate like headers.
I (INSERT) Insert a user-defined overlay line after the line in which the option has
been specified. A new line is displayed on the screen. This line is
marked O (Overlay). Information can be typed on this line. To fill in
more than 77 columns, shift left and right.
B (BEFORE) Same as INSERT, but inserts the overlay line before the line on which
the option has been specified.
D (DELETE) If this option is specified on an original page line (that is, any line other
than an overlay line), the line does not appear on the screen when the
report is viewed. The line identification is positional from the top of
the page, unless the deleted line is part of the footer, in which case the
identification is positional from the bottom of the page.
C (COLUMNS) This option identifies the selected line as a model line to be used in a
cut and paste operation that allows column reformatting. Details of
column reformatting are discussed later in this chapter. This option
causes the Column Editing screen to be displayed (discussed later in
this chapter).

Using the I (Insert) option, overlay lines can be periodically inserted between report
detail lines to make the report easier to read (for example, a blank line can be inserted
between every five records).

Used together, the D (Delete) and I (Insert) options enable you to rearrange header
line information. By inserting overlay lines into which you can type header line
information, and by deleting the original header lines, the following useful edits can
be performed:

256 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

Header lines information can be rewritten to appear only in the first 80 columns, to
conform to the screen width.

Header line information can be condensed from many header lines into one or two
Header lines, leaving more report detail lines displayed on the screen.

Example

Consider the following report page:

Figure 115 Edit Lines and Columns on the Report Editing (Ruler) Screen Example
----------------- CONTROL-D - EDIT REPORT LINES AND COLUMNS ----------(U.E.1)
COMMAND ===> SP CHAR SCROLL===> CRSR
USER PROD JOB PREMPRS2 RULER DEFAULT TYPE VIEW
REPORT EMPLOYEES REPORT
O ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+-
D 1 E M P L O Y E E S R E P O R T ----- FOR PRODUCTION DE
H EMPLOYEE EMPLOYEE OFFICE ANNUAL SOCIAL NO. OF JOB CLAS
H NO. NAME NO. SAL SECURITY NO. DEPENDENTS CODE
O ======== ============== ====== ====== ============ ========== ========
D -------- -------------- ------ ------ ------------ ---------- --------
66474 C. POHLHAMMER 23 39,500 831-62-8752 2
66475 G. MEREDITH 09 40,000 125-22-2235 3
66491 P. MILLER 12 31,500 585-47-2352 1
66498 K. BOYLE 22 39,500 832-52-5455 2
66501 R. BERLE 14 39,500 834-02-3361 2
O ----------------------------------------------------------------------------
66513 C. KING 12 30,000 988-02-8475 2
66519 G. BROWNE 02 36,500 748-38-2884 2
66524 R. SOLOMON 04 35,000 960-52-2350 3
66526 S. CUNNINGHAM 21 39,500 834-01-2852 2
66529 M. TABER 22 39,500 823-00-2352 2
O ----------------------------------------------------------------------------
66530 A. WINGER 23 39,500 823-44-5858 2
66531 B. BOOKSPAN 05 47,000 315-42-2358 4
OPTIONS: H HEADER F FOOTER D DELETE C COLUMNS I INSERT B BEFORE 12.06.26

The top line of the report does not appear when the report is displayed.

The second and third lines of the report are always used as a fixed Header line.

The user did not like the fourth line of the report; deleted it; and replaced it with a
new overlay (O) line, which is used as a fixed header.

Unmarked lines are scrollable lines.

An overlay line has been added every five lines. It is used as an eye leader for
easy reading of the report data.

Chapter 2 Online Facilities 257

Editing (Reformatting) Reports

The result is as follows:

Figure 116 Edit Lines and Columns on the Report Editing (Ruler) Screen Example
Results
----------------- CONTROL-D REPORT VIEWING -------------- PAGE 1 OF 3
COMMAND ===> SCROLL ===> CRSR
USER PROD JOBNAME PREMPRS2 JOBNUMB 0009812 DATA 080800 RULER DEFAULT
REPORT EMPLOYEES REPORT
---+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----
EMPLOYEE EMPLOYEE OFFICE ANNUAL SOCIAL NO. OF JOB CLASS
NO. NAME NO. SAL SECURITY NO. DEPENDENTS CODE
======== ============== ====== ====== ============ ========== ========
66474 C. POHLHAMMER 23 39,500 831-62-8752 2
66475 G. MEREDITH 09 40,000 125-22-2235 3
66491 P. MILLER 12 31,500 585-47-2352 1
66498 K. BOYLE 22 39,500 832-52-5455 2
66501 R. BERLE 14 39,500 834-02-3361 2
----------------------------------------------------------------------------
66513 C. KING 12 30,000 988-02-8475 2
66519 G. BROWNE 02 36,500 748-38-2884 2
66524 R. SOLOMON 04 35,000 960-52-2350 3
66526 S. CUNNINGHAM 21 39,500 834-01-2852 2
66529 M. TABER 22 39,500 823-00-2352 2
----------------------------------------------------------------------------
66530 A. WINGER 23 39,500 823-44-5858 2
66531 B. BOOKSPAN 05 47,000 315-42-2358 4
66533 R. MULU 29 39,500 821-22-5850 2
66539 E. SMART 02 29,000 681-35-3126 4
CMDS: FIND str, FIND str PREV, EDIT, RULER on/off/name, N n P n 12.06.51

Dynamic Extraction Parameters

Information that you retype into overlay lines remains constant, and is therefore
useful only if the original information remains constant (such as a report title).

Report information that may change from day to day or even from page to page (for
example, date, department number) can be rearranged using Dynamic Extraction
parameters.

Dynamic Extraction parameters allow you to extract dynamically changing

information from various locations in the report and place it into one or more header
overlay lines.

Dynamic Extraction parameters make use of a special identifying character (of your
choice), which you specify in the SP CHAR field (for example, the % character).

Dynamic Extraction parameters are defined in the overlay lines.

The basic format is:

dLnCn ...d

258 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

where

d is the special character (user-defined in the SP CHAR field of the Edit Lines
screen) that marks the beginning and end of the parameter.

Ln is the line from which you want to extract a field. n represents the line number
(1 - 256).

Cn is the first column of the field from which you want to extract. n represents the
column number (1 - 256).

You simultaneously create the Dynamic Extraction parameter and identify where the
value should be co

pied in an overlay line, as follows:

Write the Dynamic Extraction parameter in the overlay line so that the beginning
special character identifies the first column of the target location.

Type the same special character in the last column of the target location. This also
identifies how many characters are copied from the source location.

An additional format is:

dP1LnCn ...d

This parameter always extracts the value from the first page of the report and carries
it forward to every page of the report. You must enter the ruler from the first page of
the report (in the Report Viewing screen), or from the Report list, to use this format.
This parameter functions when entering the Report Viewing screen with a ruler in
effect, but not when deactivating and subsequently reactivating a ruler (using the
RULER command) on a page other than the first page of the report.

As a variation to the two Dynamic Extraction parameter formats, you can specify that
the line number is to be counted from the bottom of the page (instead of the top). To
do this, format the line number in the parameter as LLn (Lower Line number),
instead of Ln.

Thus, the parameters dLnCn and dP1LnCn would become dLLnCn and dP1LLnCn
respectively, where LLn identifies the number of lines from the last line.

NOTE
The Dynamic Extraction parameters are supported during Online viewing only.

Chapter 2 Online Facilities 259

Editing (Reformatting) Reports

Example

The following report contains 11 header lines and only eight data lines. The
information in the first seven lines can be condensed to one overlay line (and the
seven lines deleted). This would almost double the number of data lines displayed.

Figure 117 Dynamic Extraction Parameter Example

----------------- CONTROL-D REPORT VIEWING -------------- PAGE 1 OF 9
COMMAND ===> SCROLL ===> CRSR
USER DEMO JOBNAME REPORT1 JOOBNUMB 0004544 DATA 080800 RULER DEFAULT
REPORT INVENTORY REPORT
---+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----
1DATE: 08.08.00
UPDATE: 08.09.00
INVENTORY REPORT
----------------
WAREHOUSE NO: 1001 DEPARTMENT: 100 - FINAL ASSEMBLY SHOP
---- ---------------------------
SHELF QNTY QNTY QNTY QNTY IN
ITEM NO. DESCRIPTION LIFE UNIT AVAIL ORDER PROCESS
----------- ---------------- ----- ---- ------- ------- ------
1233-781-21 RIVET D. 0.1 ACR NONE KG 100.00 250.00
1233-781-25 RIVET D. 0.5 ACR NONE KG 500.00 500.00
1233-781-27 RIVET D. 0.7 ACR NONE KG 100.00 100.00
2200-700-22 RUBBER RING D. 2.2 1 MON EA 10.00 10.00
2200-700-27 RUBBER RING D. 2.7 1 MON EA 15.00 5.00
2201-750-00 MAIN WHEEL 8 MON EA 85.00 15.00
2201-751-00 NOSE WHEEL 8 MON EA 40.00 10.00
2201-800-22 METAL O RING 2.2 NONE EA 20.00 30.00
CMDS: FIND str, FIND str PREV, EDIT, RULER on/off/name, N n P n 10.07.03

In the Edit Report Lines and Columns screen:

The special character % is defined.

----------------- CONTROL-D - EDIT REPORT LINES AND COLUMNS ----------(U.E.1)

COMMAND ===> SP CHAR % SCROLL===> CRSR
USER DEMO JOB JDEMO RULER DEFAULT TYPE VIEW
REPORT INVENTORY REPORT
O ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+--

Header lines are defined and an overlay line is inserted.

The overlay line is filled in with the desired text and Dynamic Extraction
parameters. For example, parameter %L2C10 % (which is eight characters in
length) extracts eight columns of information beginning from line 2, column 10
(the Update date).

260 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

Unnecessary header lines are deleted using option D.

O ----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+-
. . .
H ---- ---------------------------
O INVENTORY REPORT - WRHS: %L6C16%DEPT:%L6C38%DTE: %L1C10 % UPD: %L2C10 %
H
H SHELF QNTY QNTY QNTY QNTY

The results are as follows:

Figure 118 Dynamic Extraction Parameter Example Results

----------------- CONTROL-D REPORT VIEWING -------------- PAGE 1 OF 9
COMMAND ===> SCROLL ===> CRSR
USR DEMO JOBNAME JDEMO JOBNUMB 0004544 DATA 080800 RULER ORDER1
REPORT INVENTORY REPORT
---+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----
INVENTORY REPORT - WRHS: 1001 DEPT: 100 DTE: 08.08.00 UPD: 08.08.00
SHELF QNTY QNTY QNTY QNTY IN
ITEM NO. DESCRIPTION LIFE UNIT AVAIL ORDER PROCESS
----------- ---------------- ----- ---- ------- ------- ------
1233-781-21 RIVET D. 0.1 ACR NONE KG 100.00 250.00
1233-781-25 RIVET D. 0.5 ACR NONE KG 500.00 500.00
1233-781-27 RIVET D. 0.7 ACR NONE KG 100.00 100.00
2200-700-22 RUBBER RING D. 2.2 1 MON EA 10.00 10.00
2200-700-27 RUBBER RING D. 2.7 1 MON EA 15.00 5.00
2201-750-00 MAIN WHEEL 8 MON EA 85.00 15.00
2201-751-00 NOSE WHEEL 8 MON EA 40.00 10.00
2201-800-22 METAL O RING 2.2 NONE EA 20.00 30.00
2274-711-21 WASHER D. 0.1 NONE KG 10.50 10.50
2274-711-25 WASHER D. 0.5 NONE KG 450.00 400.00
2274-811-21 BOLT 1/8 NONE KG 50.00 25.00
2274-811-27 BOLT 1/32 NONE KG 55.00 50.00
2284-811-21 NUT 1/8 NONE KG 55.00 20.00
2284-811-27 NUT 1/32 NONE KG 55.00 50.00
CMDS: FIND str, FIND str PREV, EDIT, RULER on/off/name, N n P n 10.07.03

Column Editing (Reformatting)

To edit (reformat) report columns, enter C (Columns) next to the line selected as the
model line in the Edit Lines and Columns screen. The Column Editing screen is
then displayed.

Chapter 2 Online Facilities 261

Editing (Reformatting) Reports

Figure 119 CONTROL-D Column Editing Screen

------------------- CONTROL-D - EDIT REPORT COLUMNS ----------------(U.E.1.C)
COMMAND ===> LINES 001 - L01
USER PROD JOB PREMPRS2 RULER EMPVAC TYPE VIEW
REPPORT EMPLOYEES REPORT
THE ORIGINAL LINE
----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----
EMPLOYEE EMPLOYEE OFFICE ANNUAL SOCIAL NO. OF JOB CLASS

Use the following 5 lines to Cut & Paste, Color and Freeze columns
CUT :

PASTE :

COLOR :

HILITE:

FREEZE:

THE RESULTING LINE

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

EMPLOYEE EMPLOYEE OFFICE ANNUAL SOCIAL NO. OF JOB CLASS

TO SHIFT, PLACE CRSR ON THE DESIRED LINE AND USE PF10-LEFT, PF11-RIGHT 12.38.12

The original line displays the selected model line.

The resulting line displays the model line as reformatted.

Both the original and resulting lines include a column number line for easy reference.

Line editing lines, summarized below, enable you to cut and paste the model line,
define colors, and highlight and freeze particular columns:

Cut columns cut the report line into sections to be included in the reformatted
report.

Paste reposition the cut sections.

Color columns define colors for columns included in the report.

Hilite columns define highlights for columns included in the report.

Freeze columns define columns to remain in their original positions if the display
is shifted left or right.

When reformatting, you can use the LEFT/RIGHT commands to shift display lines.

262 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

Defining the Cut

You must mark every column range that you want to reposition in the resulting line.
Each column range must start with a letter or a digit (except the letter E). The end of
the range is marked by the letter E. CONTROL-V fills each range with the character
to improve visibility.

NOTE
To move right, use the space bar and not the arrow key.

Defining the Paste

Column Pasting To reposition columns, place the letter or digit identifier in any
column of the paste input line. This causes the columns range to be moved to
the new position. You may define other characters in the new edited line. Any
character in the paste line that is not a cut identifier is treated as a filler string.

Color To specify a color for a column, enter the color code in the column on the
color line.

NOTE
Available only on terminals with seven color support.

Table 108 Color Codes for Color Line

Code Definition
R Red
G Green
B Blue
P Pink
Y Yellow
T Turquoise
W White

Highlighting To highlight columns, specify the desired highlight code in the

desired columns on the Hilite line.

Chapter 2 Online Facilities 263

Editing (Reformatting) Reports

NOTE
Available only on terminals with seven color support.

Table 109 Highlight Codes for Hilite Line

Code Definition
U Underscore
R Reverse video
B Blink
blank Regular

Column Freezing Type the letter F in the Freeze line to freeze any column you
would like retained in its original position (even when the display is shifted).

Seeing the Result After you have defined the cut, paste, freeze, color and
highlight, press Enter and the modified line is displayed in the Resulting line.

Specifying a Line Range

The Line Range fields (on the right side of the COMMAND line) enable you specify a
line range for the desired cut and paste. This is especially useful if you want to
exclude headers and footers from the cut and paste operation.

Line Range works as follows:

The defined range specifies line numbers within a report page, not line numbers
relative to the whole report. For example, a value of 010 refers to the tenth line on
each page, not the tenth line in the report.

Line number values can be defined either in the format n or Ln. n may be any
integer from 00 to 256. Line numbers are counted from the top of the page in
format n and from the bottom of the page in format Ln.

Example: If the top three and bottom two lines are header or footer lines which you
do not want formatted, specify a line range of 004 L03.

Modifying a Line Range

The column editing (formatting) for any line or line range can be modified or
redefined. Later specifications for a line (range) supersede earlier ones. However, the
original definition is retained for any part of a line range that is not explicitly
redefined.

264 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

For example, if column editing is specified for the line range 001 L01 and then
respecified for the line range 003 L02, the original specification is still in effect for
lines 001, 002 and L01. To remove the ruler specification for lines 001, 002 and L01, the
original specification must be cleared.

Checking the Ruler in the Report

You may check how the ruler works in the report by using the Quick Ruler Definition
key (PF04/PF16) which switches between the current ruler definition screen (in this
case the Column Editing screen) and the Report Viewing screen. When using this key,
the ruler edits are applied to the report in the Report Viewing screen, enabling you to
see if the ruler works as you want, or if further revision is necessary, before exiting
the ruler.

When you are satisfied with the ruler edits, switch back to the ruler definition screen
and exit. For more information see Exiting the Ruler Definition Environment later
in this chapter.

Example

Perform the following edits in the Column Editing screen:

Figure 120 Column Editing (Reformatting) Example

------------------- CONTROL-D - EDIT REPORT COLUMNS ----------------(U.E.1.C)
COMMAND ===> LINES 001 - L01
USER PROD JOB PREMPRS2 RULER EMPVAC TYPE VIEW
REPORT EMPLOYEES REPORT
THE ORIGINAL LINE
----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----
EMPLOYEE EMPLOYEE OFFICE ANNUAL SOCIAL NO. OF JOB CLASS
Use the following 5 lines to Cut & Paste, Color and Freeze columns
CUT :
1-------E2---------------E3------E4------E5------------E6----------E7---------
PASTE :
2 | 3 | 4 | 6
COLOR :
HILITE:
FREEZE:
THE RESULTING LINE
----+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----
EMPLOYEE | OFFICE | ANNUAL | NO. OF

TO SHIFT, PLACE CRSR ON THE DESIRED LINE AND USE PF10-LEFT, PF11-RIGHT 13.01.08

Press the Quick Ruler Definition key (PF04/PF16) to check the results. The Report
Viewing screen appears as follows:

Chapter 2 Online Facilities 265

Editing (Reformatting) Reports

Figure 121 Column Editing (Reformatting) Example Result

----------------- CONTROL-D REPORT VIEWING -------------- PAGE 1 OF 3
COMMAND ===> SCROLL ===> CRSR
USER PROD JOB PREMPRS2 09812 DT 080800 RULER EMPVAC TYPE VIEW
REPORT EMPLOYEES REPORT
---+----1----+----2----+----3----+----4----+----5----+----6----+----7----+----
EMPLOYEE | OFFICE | SICK | VAC
NAME | NO. | DAYS | DAYS
=============== ======== ====== ======
C. POHLHAMMER | 23 | 01 | 07
G. MEREDITH | 09 | 00 | 01
P. MILLER | 12 | 00 | 02
K. BOYLE | 22 | 01 | 07
R. BERLE | 14 | 01 | 07
--------------------------------------
C. KING | 12 | 00 | 00
G. BROWNE | 02 | 00 | 07
R. SOLOMON | 04 | 01 | 07
S. CUNNINGHAM | 21 | 01 | 07
M. TABER | 22 | 04 | 07
--------------------------------------
A. WINGER | 23 | 00 | 07
B. BOOKSPAN | 05 | 03 | 08
R. MULU | 29 | 01 | 07
E. SMART | 02 | 09 | 07
CMDS: FIND str, FIND str PREV, EDIT, RULER on/off/name, N n P n 13.01.14

Press the Quick Ruler Definition key (PF04/PF16) again to return to the ruler.

Exiting the Column Editing Screen

Enter the END command (PF03/PF15). The column definition is kept in memory.

If you do not want to keep the last changes you made in the Column Editing screen,
use the CANCEL or RESET command to exit the screen.

Include Lines Based on Strings

This option enables you to define lines to be displayed or printed based on line
contents. The screen in Figure 122 is displayed when you enter option 2.

266 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

Figure 122 Include Lines Based on Strings on the Report Editing (Ruler) Screen
---------------- CONTROL-D - INCLUDE LINES BASED ON STRINGS ----------(U.E.2)
COMMAND ===> Apply on header N
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
STR COL - LINE - COLOR HL
PLEASE FILL IN THE SELECTION STRINGS 13.02.28

The Include screen limits the records included in a report to those records containing
a specified strings in a specified locations:

STR is the string used for comparison.

COL is the column range for the string comparison.
LINE is the line range for the string comparison.

A maximum of 20 different search strings, with line and column ranges, can be
defined. Searches begin with the first include string specified and progress to the last
Include string specified. Multiple include strings have an OR relationship: Once a
line is matched to an include string, the line is included (and the specified color and
highlighting applied); no further string searches are made on that line.

Include lines can contain logical comparison operators. The operators must start in
the first column of the STRING field. The comparison is made character after
character (it is not an algebraic comparison). The format of the comparison operators
is as follows:

STRING ===> .op.string

op is the comparison operator. Periods on both sides of the operator are

mandatory.

Chapter 2 Online Facilities 267

Editing (Reformatting) Reports

The following operators are supported:

.GT. Greater than

.LT. Less than
.GE. Greater than or equal to
.LE. Less than or equal to
.NE. Not equal to

string is the string used for comparison. The string can contain leading blanks. It
can also be embedded in quotes.

Example 1

STRING ===> OVERDRAWN

If the line contains the string OVERDRAWN (in the specified columns), the line is
included in the report. The absence of a logical operator (for example, .LT.) means
that equals is the implied logical operator (that is, an exact match is sought).

Example 2

STRING ===> .NE.BALANCED

If the line does not contain the string BALANCED (in the specified columns), the line
is included in the report.

Example 3

STRING ===> .GT. 10000

If the line contains an amount greater than 10000 (in the specified columns), the line is
included in the report. The comparison includes the three leading blanks.

Apply on Header

The Apply on Header field specifies whether the Include criteria should (Y) or should
not (N) be applied to report header and footer lines, as follows:

Y (Yes) Apply the Include criteria to the header and footer lines. Header and
footer lines are included in the report only if they conform to the Include criteria.

N (No) Do not apply the Include criteria to header and footer lines. Header and
footer lines are included in the report regardless of Include criteria. Default.

268 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

Line Range Fields

The Line Range fields allow you to limit the Include search to a specific line range on
each page as follows:

The defined range specifies line numbers within a report page, not line numbers
relative to the whole report. For example a value of 010 refers to the tenth line on each
page, not the tenth line in the report.

Line number values can be defined either in the format n or Ln. n may be any integer
from 001 256. Line numbers are counted from the top of the page in format n and
from the bottom of the page in format Ln.

NOTE
When a line range is specified, lines that are not within the specified range are included in the
report.

Example

If you specify a line range of 004L03, only the fourth line from the top through the
third line from the bottom is checked and they are included only if they meet the
Include criteria. The first three and last two lines are not included in the check and
therefore are included in the report.

Color the Line

If you fill in the color and highlight fields for the included string, the entire line is
colored.

NOTE
Available only on terminals with seven-color support.

Table 110 Color Codes for Line Range Fields

Code Definition
R Red
G Green
B Blue
P Pink
Y Yellow
T Turquoise
W White

Chapter 2 Online Facilities 269

Editing (Reformatting) Reports

Table 111 Highlight Codes for Line Range Fields

Code Definition
U Underscore
R Reverse video
B Blink
blank Regular

The Include Lines Based on Strings option can be used for viewing the results of a
job run. For example, it is possible to display only those lines containing step names
with condition codes. It is also possible to include other lines, such as JCL errors,
abend codes, NOT CATLGD 2, and so on.

This option can also be used to differentiate records by string content. For example,
use one Include line to display records greater than $100,000 in red; use another
Include line to display records greater than $50,000 in blue; and use a third Include
line to display records greater than $10,000 in yellow.

Exclude Lines Based on Strings

The Exclude option (Option 3 Exclude lines based on strings) operates almost
identically to the Include option. It differs in that it determines lines to be excluded
from the report based on strings. Since it identifies lines to be excluded, color and
highlight parameters are unnecessary and do not appear in the Exclude screen.
Logical operators work on the Exclude screen just as they do on the Include screen.

Rulers Containing Both Include and Exclude Criteria

When your ruler contains both include and exclude criteria, the include strings are
searched first and the exclude strings afterwards. A line meeting both inclusion and
exclusion criteria, or a line not meeting either include or exclude criteria, is excluded.

Color Lines Based On Strings

This option allows you to specify report viewing colors for specific lines and columns
based on string occurrence in the report page. String specification in the Color Lines
screen does not limit record inclusion or exclusion in the report, and color and
highlight definition is more flexible in the Color Lines screen than in the Include and
Exclude screens.

270 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

When this option is chosen, the following screen is displayed:

Figure 123 Color Lines Based On Strings Screen

------------------ CONTROL-D - COLOR LINES BASED ON STRINGS ----------(U.E.4)
COMMAND ===> Apply on header Y
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
PLEASE FILL IN THE SELECTION STRINGS 13.03.02

Each String and Color definition is comprised of two lines:

ON STR line

Identifies the string and its column (and line) range. If the string is found, coloring is
applied as specified in the next (COLOR) line.

Table 112 ON STR Line Fields

Field Description
ON STR The search string is specified in this field.
COL Column range in which the search is made for the string. Maximum
column range is 001 256.
LINE Line range in which the search is made for the string. Line number
values can be defined in either n format or Ln format. Line numbers in
n format are counted from the top of the page; line numbers in Ln
format are counted from the bottom of the page. Maximum line range
is 001 256; the line range applies to each page of the report.

Logical operators are recognized in string specification (as described under the topic
Include Lines Based on String above).

Chapter 2 Online Facilities 271

Editing (Reformatting) Reports

COLOR line

This line specifies the color (and/or highlight) code to be applied, and how it should
be applied:

Table 113 Color Line for Color Lines Based on Strings Screen
Code Definition
COLOR Desired color code. Valid values:

R Red
G Green
B Blue
P Pink
Y Yellow
T Turquoise
Q White
HILITE Desired highlight code. Valid values:

U Underscore
R Reverse video
B Blink
blank Regular
ON Specify how the color and highlight codes should be applied if the
string is found in the specified location. Indicate Y (Yes) in one of the
following Y/N fields:

STRING Color and highlight the found string only

LINE Color and highlight the entire line where the string is
found

COL/LINE range Color and highlight the column and line range
specified in these fields. These values may differ from the COL and
LINE where the string is found

The Color Lines screen also has an Apply on Header field that optionally applies the
color criteria if the string is found in the header line.

Example

Below is an example of a Color Lines Based on Strings definition, followed by an

indication of the resulting color coding in the report.

272 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

Figure 124 Color Lines Based on Strings Example

------------------ CONTROL-D - COLOR LINES BASED ON STRINGS ----------(U.E.4)
COMMAND ===> Apply on header N

ON STR 11 COL 030 - 031 LINE -

COLOR B HILITE ON: STRING or LINE Y or COL - LINE -
ON STR .GT. 05 COL 101 - 102 LINE -
COLOR R HILITE ON: STRING Y or LINE or COL - LINE -
ON STR .GT. 10 COL 107 - 108 LINE -
COLOR G HILITE ON: STRING Y or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
ON STR COL - LINE -
COLOR HILITE ON: STRING or LINE or COL - LINE -
PLEASE FILL IN THE SELECTION STRINGS 17.53.56

In the above example:

If columns 30 and 31 contain the value 11, color the entire line blue.

If columns 101 and 102 contain a value greater than 05, then color the string red.

If columns 107 and 108 contain a value greater than 10, color the string green.

Exiting the Ruler Definition Environment

When you enter the END command (PF03/PF15) from the Ruler Definition entry
panel and you have already entered a ruler, an Exit Option window is displayed.

Chapter 2 Online Facilities 273

Editing (Reformatting) Reports

Figure 125 Ruler Definition Environment Exit Option Window

------------------------ CONTROL-D - REPORT EDITING --------------------(U.E)
COMMAND/OPT ===> +---------------------------------+
USR PROD REP EMPLOYEES REPORT | |
| PLEASE SELECT EXIT OPTION |
| |
RULER NAME ===> EMPVAC | Exit option ===> |
RULER TYPE ===> VIEW | |
REPORT NAME ===> | 1 KEEP ruler active |
JOB NAME ===> | 2 CLEAR (no ruler) |
USER NAME ===> | 3 SAVE ruler as: |
| |
| Ruler name ===> EMPVAC |
1 EDIT report lines and columns | Ruler type ===> VIEW |
| |
2 INCLUDE lines based on strings +---------------------------------+

3 EXCLUDE lines based on strings

4 COLOR lines based on strings

PLEASE SELECT OPTION, OR PRESS PF3 TO SAVE/EXIT THE RULER 13.04.15

You can choose between three options:

1. KEEP ruler active. The ruler remains in memory and is activated on the same
report or job. It is not saved in the file for future use. The ruler is erased from
memory if you enter a new ruler name (using the RULER command), or if you
enter into a new user or report entry.

2. CLEAR. The ruler is erased from memory. The report or job is shown without a
ruler. If the ruler previously existed, it is not erased from the file, but any changes
to the ruler definition are not saved.

3. SAVE ruler as. The ruler is saved in the file with the name and type specified in the
RULER NAME and RULER TYPE fields. By default these fields contain the same
name and type used when the ruler definition began. You can change the ruler
name and the ruler type when saving rulers. If a previous ruler with the same
name exists, it is overwritten by the new ruler. For a View ruler, the new name is
the current active ruler.

Quick Ruler Definition PFKey (PF04/PF16)

While defining a new ruler, it may be cumbersome to use the Exit Option window to
switch between the Report Viewing screen and the Edit screen to evaluate the ruler.
The Quick Ruler Definition PFKey allows you to bypass the Exit Option window.

274 CONTROL-D and CONTROL-V User Guide

 Editing (Reformatting) Reports

NOTE
The Quick Ruler Definition key is not available when the Ruler Definition environment was
entered through option E from the Active User Report list.

The Quick Ruler Definition PFKey alternately displays the current ruler definition
screen and the Report Viewing screen. It applies the edits you are currently defining
to the report, so that you can evaluate the ruler. If you are satisfied with the results,
you can switch back to the Edit screen to SAVE or KEEP the ruler.

More About Rulers

A ruler can be defined as the DEFAULT ruler for a report. If a DEFAULT ruler exists
for the report, the report is automatically displayed according to the DEFAULT ruler
when you enter the Report Viewing screen. If no DEFAULT ruler exists for the report,
the report is displayed without a ruler (that is, in its original format) when you enter
the Report Viewing screen.

RULER Command
The RULER command is used to activate (turn on), deactivate (turn off), and switch
between rulers.

Table 114 RULER Command Formats

Format Description
RULER name makes the named ruler your current ruler and turns it on.
RULER OFF turns off your current ruler.
RULER ON turns on your current ruler.
RULER (without Alternately turns your current ruler on and off.
the OFF, ON or
name qualifier)

The RULER command can be abbreviated RU, but OFF, ON and the ruler name
cannot be abbreviated.

The RULER command can be used in the Active User Report List screen to toggle the
ruler show mode on and off. For details see Commands of the User Report List
earlier in this chapter.

Chapter 2 Online Facilities 275

Tag Notes

Global Rulers ($ruler)

Users authorized by the INCONTROL administrator (that is, users authorized in the
Recipient Tree to access $SYSDATA records) can define rulers for global usage. This
is done by prefixing the ruler name with $ in the Exit Option window.

Global rulers can be created, modified, or deleted by authorized users only. However,
all users can access global rulers in report viewing. Global rulers do not belong to a
specific user, report, or job. Using CONTROL-D Exit CTDX004, it is possible to use a
global ruler or the default ruler. For details about global rulers, see the description of
Exit CTDX004 in the Exits chapter of the INCONTROL for z/OS Administrator Guide.

For example, ruler $JOBCHK is a predefined ruler that restricts lines in MSGCLASS
output to common messages and strings relevant to production personnel.

Page Mode Rulers

Rulers which refer to a specific line on a page are called page mode rulers. When the
ruler is activated, report pages are displayed with a separator line (like Bottom of
Page). The HEX command is not available when a page mode ruler is active. (For
more information see HEX Command earlier in this chapter.)

Tag Notes
Tag notes can be attached to specific substrings of a report in the Report Viewing
screen. For more information see Notepad Facility earlier in this chapter for an
explanation of notes.

Tag notes are linked to rulers. A Tag note that is defined when no ruler is active is
accessible only when no ruler is active. A Tag note defined when any ruler is active is
accessible only when that same ruler is active.

The top line of the Report Viewing screen indicates the total number of Tag notes in
the report for the current ruler (A), if any.

To define a Tag note for a substring, use the arrow keys to position the cursor on the
first character of the substring to be tagged and press PF06. Then use the arrow keys
to move the cursor to the last character of the substring to be tagged and press PF06
again. The Tag Note window is opened. Both general notes and tag notes can have
multiple versions. For details about creating, modifying, and deleting a version of a
note, see Notepad Facility earlier in this chapter.

276 CONTROL-D and CONTROL-V User Guide

 Tag Notes

Figure 126 Tag Note Window

--------------- CONTROL-D REPORT VIEWING NOTES PAGE OF
COMMAND ===> +---------------------NOTE PAD FACILITY--------------(TAG)-+
USR ACTG1 | EDIT VERSION 0001 N44 08/08/00 21:56:14 |
REPORT EMPLOYEES R| |
----+----1----+--- | |
====== NEW PAGE == | |
DATE: 05.05.00 | |
UPDATE: 05.05.00 | |
| |
| |
| |
WAREHOUSE NO: 100 | |
--- | |
| |
| F3:END F7:CLEAR F8:DELETE |
+----F5:SAVE--------------F10:PREV-------------F11:NEXT----+
ITEM NO. DESCRIPTION LIFE UNIT AVAIL ORDER PROCESS
----------- ---------------- ----- ---- ------- ------- ------

1233-781-21 RIVET D. 0.1 ACP

NONE KG 100.00 250.00
1233-781-25 RIVET D. 0.1 ACP
NONE KG 100.00 250.00
1233-781-27 RIVET D. 0.1 ACP
NONE KG 100.00 250.00
CMDS: FIND str (PREV), EDIT, RULER on/off/name, N n P p 21.56.07

There are two ways to open an existing Tag note: use the arrow keys to position the
cursor on any column of the tagged substring and press PF06, or type GETNOTE on
the command line, position the cursor on any column of the tagged substring, and
press Enter. The Tag Note window is opened and the existing Tag note is displayed.

By default, tagged substrings are displayed in red. If the report line is red, the tagged
substring is displayed in yellow. On monochrome terminals, the tagged substring is
highlighted.

If a tagged substring has been moved as a result of subsequent ruler edits, the tag is
not identified (via color or highlighting) when the Report Viewing screen is displayed
and an appropriate message is issued. Pressing PF06 colors (or highlights) the tagged
columns.

NOTE
The original substring location (that is the columns, not the substring) is actually tagged.

Even when WRAP mode is on, notes can only be attached to substrings within
the first 256 characters of data on a line.

Chapter 2 Online Facilities 277

Using the Report Viewing Screen To View AFPDS Reports On 3270 Monitors

SHOWNOTE Command
The SHOWNOTE command (abbreviated SHOWN) alternately changes (toggles) the
color of tagged substrings from red (or yellow) to the color of the report lines.

LOCNOTE Command
The LOCNOTE command (abbreviated LOCN) locates the next report note.

Using the Report Viewing Screen To View AFPDS Reports On

3270 Monitors
This option enables AFPDS (AFP Category 5) reports to be viewed in the Report
Viewing screen on 3270 monitors. Text is extracted from the AFP report and
displayed according to positions defined in the AFP report for this text. Text from
overlays is not displayed.

To activate the AFP viewing option, issue command RUL $AFPxxx from the Report
Viewing screen. This command invokes a special filter that displays only the text of
the current report. Ruler $AFPxxx is applied to the extracted text. Specify only the
ruler name prefix in the command (that is, RUL $AFP), so that any ruler (prefixed
$AFP) can activate the AFP filter.

When extremely large or small fonts are used, calculation of text positions can result
in overlapping text. The calculation algorithm in cases of extremely large or small
font can be adjusted by specifying, a multiplication or division factor in the reports
REMARK field.

Parameters C and L allow expansion or shrinkage during the graphic-to-text

conversion. Format of the parameter is:

{C=xnn},{L=xnn}

where

C is the column factor.

L is the line factor.

x is the factor operator. Valid values are * (multiply) and / (divide). To enlarge
the font, enter * as the factor operator; To decrease the font, enter / as the factor
operator.

278 CONTROL-D and CONTROL-V User Guide

 $SYSDATA Records

nn is the two-digit factor applied as an integer in base of 10 units. For example, to

enlarge a font by 50%, enter a factor of 15, which is used a 1.5 multiplication. To
double the font size, enter 20, and so on.

Any factor combination can be specified: column only, line only, both column and
line (separated by commas), or neither.

The program searches for a C or L parameter in the REMARK field. If neither are
found, the original calculation is used. Otherwise, the factor is applied to the
conversion algorithm.

Examples

To expand line spacing by 50%, enter L=*15, which effectively means that the filter
formula is multiplied by 1.5.

To shrink the line spacing by 50%, enter L=/15.

To expand the column spacing by 30%, enter C=*13.

$SYSDATA Records
A special user ID ($SYSDATA) is used to display a list of the original reports (before
decollation). This user ID is reserved for authorized persons only. $SYSDATA records
appear only in Active, Migrated and History Report lists.

The values specified in the fields of the User Reports entry panel shown below
produce a list of $SYSDATA records for CONTROL-V migrated reports.

Chapter 2 Online Facilities 279

$SYSDATA Records

Figure 127 User Reports Entry Panel Values to Produce $SYSDATA

Records in CONTROL-V Migrated Reports
-------------------- CONTROL-D/V - USER REPORTS ENTRY PANEL ---------------(U)
COMMAND ===>

OPTIONS ===> 1. PERMANENT 2. ACTIVE/MIGRATED 3. HISTORY

REPORT NAME ===> Report name, prefix or mask

USER ===> $SYSDATA Recipient name or prefix
DATE FROM ===> TO Report date or relative day
JOBNAME ===> Job name, prefix or mask

SHOW MIGRATED ===> O Include migrated reports

INDEX ===> Index name, prefix or mask

VALUE ===>

DISPLAY TYPE ===> D BYPASS PANEL ===> N

Two basic formats for $SYSDATA records are predefined:

Short format: Displayed when you request any display type for user $SYSDATA. If
you activate the A (Additional Info) option on an entry, you receive the Long
format.

Long format: Displayed when you activate the A (Additional Info) option for user
$SYSDATA.

$SYSDATA Short formats for the History and Active Report lists are shown below:

Figure 128 $SYSDATA Short Format for History List

HISTORY LIST <D> JOB REP USR $SYSDATA CHILD (U)
COMMAND ===> SCROLL===> CRSR
O JOB JNUM PROCSTEP PGMSTEP DDNAME PAGES LINES DEC-DATE RETAIN
M022AIB 7736 JES2 $SYSMSGS 1 66 08/08/00 08/08/00
M022AIB 7958 JES2 SYSPRINT 98 2478 08/08/00 08/08/00

280 CONTROL-D and CONTROL-V User Guide

 $SYSDATA Records

Figure 129 $SYSDATA Short Format for Active List

ACTIVE LIST <> JOB REP USR $SYSDATA CHILD (U)
COMMAND ===> SCROLL===> CRSR
O JOB JNUM PROCSTEP PGMSTEP DDNAME PAGES LINES DECOLLATION-TIME
M225MSGD 8463 JES2 $SYSMSGS 1 93 08/08/00 - 11:01
M225MSGD 8463 KSL DAKSLOUT 5 483 08/08/00 - 11:01
M225MSGD 8463 KSL DAKSLREP 1 60 08/08/00 - 11:01
PRDKPL01 8639 JES2 $JES2LOG 1 9 08/08/00 - 11:02
PRDKPL01 8639 JES2 $JCLIMG 1 25 08/08/00 - 11:02
PRDKPL01 8639 JES2 $SYSMSGS 1 5 08/08/00 - 11:02
PRDKPL02 8657 JES2 $JES2LOG 1 25 08/08/00 - 11:03
PRDKPL02 8657 JES2 $JCLIMG 1 30 08/08/00 - 11:03
PRDKPL02 8657 JES2 $SYSMSGS 2 130 08/08/00 - 11:03
PRDKPL03 9723 JES2 $JES2LOG 1 25 08/08/00 - 11:03
PRDKPL03 9723 JES2 $JCLIMG 1 31 08/08/00 - 11:03
PRDKPL03 9723 JES2 $SYSMSGS 2 130 08/08/00 - 11:03
PREMPRS1 8879 JES2 $JES2LOG 1 15 08/08/00 - 11:02
PREMPRS1 8879 JES2 $JCLIMG 1 11 08/08/00 - 11:02
PREMPRS1 8879 JES2 $SYSMSGS 1 44 08/08/00 - 11:02
PREMPRS1 8879 STEP1 SYSPRINT 1 4 08/08/00 - 11:02
PREMPRS1 8879 STEP2 SYSPRINT 1 4 08/08/00 - 11:02
PREMPRS2 9812 STEP1 SYSUT2 9 427 08/08/00 - 11:06
PREMPRS2 9812 STEP2 SYSUT2 8 328 08/08/00 - 11:06
P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT
X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 08.02.09

Fields in the $SYSDATA Short Format

Table 115 Fields in the $SYSDATA Short Format

Field Description
JOB Name of the job that created the report.
JNUM Job number.
a
PROCSTEP Step name in the JCL procedure that creates the report.
a
PGMSTEP Job step name that creates the report.
DDNAMEa Name of the DD statement under which the report was created.
PAGES Number of pages in the report.
LINES Number of lines in the report.
DECOLLATION Date and time of report decollation (in Active Report list).
TIME
DEC-DATE Date of decollation (in History Report list).
RETAIN Retention date. Last date the archived report is kept (in History Report
list).
a For reports created using the ALLOCOPT options ONEDSN or JOBSDSN1, the procstep,
pgmstep and ddname are from the first JES dataset of the job. The procstep, pgmstep and ddname
of other JES datasets are not shown.

Chapter 2 Online Facilities 281

$SYSDATA Records

Active and History Report $SYSDATA Records (Additional

Info)
Below is the $SYSDATA Long format that is displayed when activating option A
(Additional Info) for an entry on the History or Active Report list.

Figure 130 $SYSDATA Long Format for History List

HISTORY LIST <A> JOB REP USR $SYSDATA CHILD (U)
COMMAND ===> SCROLL===> CRSR
O JOB JNUM PROCSTEP PGMSTEP DDNAME PAGES LINES DEC-DATE RETAIN
MMUPRE03 422 STEP1 SYSUT2 9 427 08/08/00 08/08/00
CDAM: IOAP.C.MMUPRE03.J00422.D1071127.S91.N002900 Extents: 00
Retention days : 0032

Figure 131 $SYSDATA Long Format for Active List

ACTIVE LIST <A> JOB REP USR $SYSDATA CHILD (U)
COMMAND ===> SCROLL===> CRSR
O JOB JNUM PROCSTEP PGMSTEP DDNAME PAGES LINES DECOLLATION-TIME
M89RKSL 28695 JES2 JESMSGLG 1 25 08/08/00 - 11:21
CDAM: CTDP.R5.M89RKSL.J28695.D3601121.S91.N004700 Extents: 00
Record ID : AC2D25AE 54529000 RBA: 000004E0 UPDT: AC2D25AE 54529000
Backup Missions :
Backup Volumes :
Restore Mission :
Migration Mission :
Creation Date : D99360 - T112113 Status: Decollated
Printing Parameters: CLASS: X FORMS: STD RECFM: UA ALOPT :
APA : N FCB : **** LRECL: 00133 WTR :
ACIF : N UCS : **** BLKSZ: 00133 OUTPUT:
TRC : N FLASH: OPTCD: MODIF :
LINCT: 0100 PGDEF: FMDEF :
CHARS: , , ,
Job Parameters : SYSID: JTYPE: ACCOUNT:
ENTRY: -
------------------------------ end of record ---------------------------------
M89RKSL 28695 JES2 JESJCL 3 231 08/08/00 - 11:21
PRDKPL01 8639 JES2 JESYSMSG 13 357 08/08/00 - 11:21
P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT
X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 08.02.09

Fields in the Active and History Report $SYSDATA Long Format

Table 116 Fields in the Active and History Report $SYSDATA Long Format (part 1 of 2)
Field Description
CDAM Name of the CDAM dataset containing the report and number of
CDAM extents.
Record ID Internal record identifier.
Backup Missions Name of backup missions that back up this report.
Backup Volumes Tape volume serial numbers on which the report is backed up.
Restore Mission Name of restore mission used to restore the report.

282 CONTROL-D and CONTROL-V User Guide

 $SYSDATA Records

Table 116 Fields in the Active and History Report $SYSDATA Long Format (part 2 of 2)
Field Description
Migration Mission Name of migration mission used to migrate the report (in the
Active/Migrated file only). The user can change the value of this field.
Creation Date Sysout creation date in Julian format: Dyyjjj Thhmmss.

Printing Parameters

Table 117 $SYSDATA Printing Parameters (part 1 of 2)

Parameter Description
CLASS Printing (sysout) class.
FORMS JCL FORMS parameter.
RECFM Record format.
ALOPT CDAM allocation option.
APA Report to be viewed in CONTROL-D/WebAccess Server by using the
AFP viewer. Valid values: Y/N.
FCB JCL FCB parameter.
LRECL Logical record length.
WTR JCL external writer name.
ACIF Report to be processed by ACIF utility during Deferred printing. Valid
values: Y/N.
UCS JCL UCS parameter.
BLKSZ Original blocksize.
OUTPUT Name of output statement.
TRC Table Reference Character.
FLASH JCL FLASH parameter.
OPTCD JCL OPTCD parameter.
MODIF JCL MODIFY parameter.
LINCT Number of lines per page.
PGDEF PAGEDEF (for AFP output).
FMDEF FORMDEF (for AFP output).
CHARS Up to four character sets.
Job Parameters Job parameters of the job that created the report.
SYSID System ID.
JTYPE Type of job.
ACCOUNT Job account information.
ENTRY Operating system timestamp of the job entering the system.
Status General status of the SYSDATA entry.
RBA Address of the record in the file.

Chapter 2 Online Facilities 283

$SYSDATA Records

Table 117 $SYSDATA Printing Parameters (part 2 of 2)

Parameter Description
UPDT Timestamp indicating when the record was last changed.
Retention Days Number of days to keep the backup (in History list).

Migrated Report $SYSDATA Records

Below is the $SYSDATA Long format that is displayed when requesting the All Fields
display type, or when activating option A (Additional Info), for an entry on the
Migrated Report list.

Figure 132 Migrated Report List

-------------------- Primary Migrated CDAM ----------------------------------
CDAM NAME: OPV.CTDP.E2.RPT00E09.J28089.E3081354.N007800
Media: FTK1 Migrate Volume: Platter:
Migration date / Last refresh date: 08/08/00
-------------------- Secondary Migrated CDAM --------------------------------
CDAM NAME: OPZ.CTDP.E2.RPT00E09.J28089.G3081354.N007800
Media: DISK Migrate Volume: WORK01 Platter:
Migration date / Last refresh date: 04/06/00
-------------------- Migration Log Information ------------------------------
Number of entries: 04
01 OPZ.CTDP.E2.RPT00E09.J28089.F3081354.N007800 Secondary Deleted
Mig. date: 04/03/00 Media: DISK Volume: WORK01 Platter:
02 OPZ.CTDP.E2.RPT00E09.J28089.E3081354.N007800 Secondary Deleted
Mig. date: 08/08/00 Media: DISK Volume: WORK01 Platter:
03 OPZ.CTDP.E2.RPT00E09.J28089.D3081354.N007800 Secondary Deleted
Mig. date: 04/03/00 Media: DISK Volume: *U Platter:
04 OPV.CTDP.E2.RPT00E09.J28089.D3081354.N007800 Primary Deleted
Mig. date: 04/03/00 Media: FTK1 Volume: Platter:
05
Mig. date: Media: Volume: Platter:
06
P PRINT V VIEW U UPDATE I INSERT A ADD INFO E EDIT
X INDEX N NOTE G GIVETO D DELETE Q QUICK ACCESS 12.14.35

Primary Migrated CDAM

Table 118 Primary Migrated CDAM Fields Migrated Report List

Field Description
CDAM NAME File name of the report on the migrated media.
Media Name of current media.
Migrate Volume Volume of the current media. Relevant only for CART, DASD and OSS
media.
Platter Name of the platter where the migrated data is stored. Relevant only
for OSS media.
Migration Migration date or last refresh date (if refresh has occurred).
date/Last refresh
date

284 CONTROL-D and CONTROL-V User Guide

 $SYSDATA Records

Secondary Migrated CDAM

Fields A through E (above) are repeated for secondary migration CDAM files.

Migration Log Information

Information on both Primary and Secondary migration is recorded in this section.

Table 119 Migration Log Information

Field Description
Number of entries. Number of migration log entries currently in use. Limit: 8.
The first line consists of:
Entry number The latest entry appears on the top line and becomes entry 01. The
previous entry becomes entry 02, and so on.
CDAM name File name of the report produced by migration.
Log entry type Log entry type. Valid values:

Primary Copy produced by primary migration.

Secondary Copy produced by secondary migration.
Status Status of the migrated report. Valid values:

TO BE DELETED The migrated report is not yet deleted.

DELETED The migrated report is deleted.
Secondary Copy produced by secondary migration.
The second line consists of:
Mig. date The date (in the standard date format of the site) that migration was
performed.
Media Name of the media on which the report resided in the last previous
generation.
Volume Volume of the media in the last previous generation. Relevant only
for CART, DASD and OSS media.
Platter Name of the platter in the last previous generation. Relevant only for
OSS media.

Options of the $SYSDATA List

To request one of the following options, specify the option in the O (Option) field to
the left of the job name and press Enter:

Chapter 2 Online Facilities 285

CONTROL-D for Distributed Systems

Table 120 Options of the $SYSDATA List

Option Description
V View the original sysout. You cannot activate or define a ruler on the
original sysout, but all the other regular report viewing functions are
operational.
D Delete the original sysout entry and the compressed datasets
associated with it. User records referencing this report are not deleted.
However, if a user tries to view or print this report after it is deleted,
that user receives a message that the report has been deleted. (You can
use the CTDDELRP utility to delete the user records.)
A Additional information (described on a previous page).
U Update changes to unprotected fields.

CONTROL-D for Distributed Systems

CONTROL-D for Distributed Systems is a separately licensed product for report
distribution to a Unix or Windows NT environment. If CONTROL-D for Distributed
Systems is installed at your site, you can use the features described below to specify
an external logical destination for CONTROL-D reports. For information about
activating this feature, see the CONTROL-D and CONTROL-V chapter of the
INCONTROL for z/OS Administrator Guide.

Specifying an External Destination

Use a 2-part DEST, DEF DEST, or OVERRIDE DEST field to specify an external
destination. Enter the reserved keyword CTDS in the first sub-field and enter the
external destination in the second sub-field. This specification can be made in any of
the following screens:

Table 121 Screens in which an External Destination Can be Specified

Option Screen Field Name
U.P Report List screen's Print window DEST
T.S Recipient Tree Definition screen DEF DEST
M.S Printing Mission Definition screen OVERRIDE DEST
A.Z Printing Mission Zoom screen OVERRIDE DEST

The example below illustrates how to specify an external destination in the Print
window (option U.P).

286 CONTROL-D and CONTROL-V User Guide

 CONTROL-D External Destinations Screen

Example

Figure 133 Print Window Specifying an External Destination

------------------------------------------------------------------------------

PRINT OPTION ===> 1

1 Immediate Printing
2 Deferred Printing (by Print Mission)
X Exit (no action)

COPIES 001 FORM STD CLASS R

DEST CTDS ROBERT WTR

FROM PAGE TO PAGE RULER DEFAULT

PRINT MISSIONS PRT1 PRT22 PRT56

PAGE DEF FORM DEF

REPORT

USER STEVE JOB ARCHIVE

If the external destination is not known or the desired destination is not yet defined,
enter CTDS in the first sub-field and leave the second sub-field blank to display the
CONTROL-D External Destinations Screen. This screen lists CONTROL-D for
Distributed Systems destination types and their descriptions.

CONTROL-D External Destinations Screen

The CONTROL-D External Destinations screen lists the external destinations defined
in CONTROL-D. These destinations are kept in the Permanent User Reports file and
are used by the CONTROL-D for Distributed Systems interface.

This screen can be used to select, modify, copy, or delete an existing destination or to
insert a new destination.

If, in any of the screens listed in the above table, the user specifies the reserved
keyword CTDS in the first DEST sub-field and specifies blanks or an invalid
destination in the second DEST sub-field, the CONTROL-D External Destinations
screen is displayed.

Chapter 2 Online Facilities 287

CONTROL-D External Destinations Screen

Figure 134 CONTROL-D External Destinations Screen

---------------------- CONTROL-D EXTERNAL DESTINATIONS -------------- (U.CTDS)
COMMAND ===> SCROLL===> CRSR
O DEST TYPE DESCRIPTION
DSR ctd_repo sending text reports to DSR
DSRHTML ctd_repo sending AFP/XEROX reports to DSR with trans HTML
DSRPDF ctd_repo sending AFP/XEROX reports to DSR with trans to PDF
DSRTXT ctd_repo sending AFP/XEROX reports to DSR with trans to TXT
FAX fax sending text reports to fax
FAXPCL fax sending AFP/XEROX reports to fax in PCL format
FAXPDF fax sending AFP/XEROX reports to fax in PDF format
LFS fs send text report to local file system
LFSHTML fs send AFP/XEROX reports to LFS in HTML format
LFSPDF fs send AFP/XEROX reports to LFS in PDF format
LFSTXT fs send AFP/XEROX reports to LFS in TXT format
MAIL email send text reports by e-mail
MAILATT email send reports as attacments
MAILHTML email send AFP/XEROX reports with transform. to HTML
MAILTXT email send AFP/XEROX reports by e-mail as text
===== >>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<< ======

S SELECT A ADD INFO U UPDATE C COPY I INSERT D DELETE 18.02.37

Press REFRESH (PF04/PF16) to redisplay the CONTROL-D External Destinations

screen.

Press END (PF03/PF15) to return to the previously displayed screen (for example,
Print window).

Header Fields in the CONTROL-D External Destinations

Screen
The following fields are displayed in the CONTROL-D External Destinations screen
header:

Table 122 Header Fields in the CONTROL-D External Destinations Screen (part 1 of 2)
Field Description
O(ption) Option field. For more information see Options of the CONTROL-D
External Destinations Screen below.
DEST Names of predefined external destinations (uppercase only).

288 CONTROL-D and CONTROL-V User Guide

 CONTROL-D External Destinations Screen

Table 122 Header Fields in the CONTROL-D External Destinations Screen (part 2 of 2)
Field Description
TYPE Type of Destination. One of the following values can be displayed:

email e-mail destination

fs File System destination
fsdpc File System for CONTROL-D/WebAccess Server
ft File Transfer
ftdpc File Transfer for CONTROL-D/WebAccess Server
lpr Printer
fax Fax destination
ctd_repo CONTROL-D repository destination
DESCRIPTION Description of the destination. Maximum length: 50 characters.

Options of the CONTROL-D External Destinations Screen

Table 123 Options of the CONTROL-D External Destinations Screen

Option Description
S (SELECT) Selects a specific external destination and returns this destination to the
previous screen.
A (ADD INFO) Provides additional information (host and port data plus CTDDS
attributes) for a specific external destination. Specifying option A again
(while additional information is displayed) causes the additional
information to not be displayed.
U (UPDATE) Updates the CONTROL-D external destination with changes made to
unprotected fields.
C (COPY) Copies an external destination entry to create a new entry. A
confirmation window is displayed.
I (INSERT) Opens a line for inserting a new external destination. Enter the DEST,
TYPE and DESCRIPTION fields for the new destination. When you
press Enter, fields for the required CTDDS ATTRIBUTES are
displayed. (For more information see the description of the CTDDS
ATTRIBUTES field below.) Fill in the appropriate data, enter U in the
option field, and press Enter to save the new destination.
Note: If a HOST or PORT is not specified, the default host and port
specified in member CTDSPARM of the IOA PARM library is used.
D (DELETE) Deletes the specified external destination from the list. A confirmation
window is displayed.

NOTE
Usage of the options in this screen and in related screens is controlled by CONTROL-D user
Exit CTDX026 and security module CTDSE26. For more information, see member CTDX026 in
the IOA SAMPEXIT library.

Chapter 2 Online Facilities 289

CONTROL-D External Destinations Screen

CONTROL-D External Destinations Additional Information

When option A is specified in the O(ption) column to the left of an external
destination, the following additional fields are displayed for that destination:

Table 124 CONTROL-D External Destinations Additional Information (part 1 of 2)

Field Description
HOST Name or IP address of the host where the CONTROL-D for Distributed Systems is
installed.
PORT Port number of the CONTROL-D for Distributed Systems Session Manager component.
Note: If a HOST or PORT was not specified, the default host and port specified in
member CTDSPARM of the IOA PARM library is displayed.
SEND WITH CC Indicator that determines whether carriage control characters are sent with the
transmitted data, stripped off, or with page break separator. Valid values are:

Y (Yes) Carriage control characters are sent.

N (No) Carriage control characters are stripped off.
P (Page Break) Page break carriage control characters are sent.
CONVERT TO Indicator that determines whether or not transmitted data is converted to ASCII. Valid
ASCII values:
Y (Yes) Transmitted data is converted to ASCII.
N (No) Transmitted data is not converted to ASCII.
L (add CRLF) - Transmitted data is converted to ASCII and line separators CRLF are
added when converting text reports from EBCDIC to ASCII. This is useful for
transforming text reports to PDF.

290 CONTROL-D and CONTROL-V User Guide

 CONTROL-D External Destinations Screen

Table 124 CONTROL-D External Destinations Additional Information (part 2 of 2)

Field Description
CTDDS The destination TYPE determines which attributes are displayed. For information about
ATTRIBUTES destination attributes, see the CONTROL-D/Desktop Administrator Guide.

This attribute area can include the following fields, which are resolved during printing.

%EMAIL%, %FOLDER%, %FAX%

These fields are resolved by the variables defined in the recipient tree of the
corresponding recipient. In order to use this option, the corresponding definition
should be performed in the DESC (description) field of the recipient tree. For
example:

RECIPIENT MGT RECIPIENT LEVEL 20 PARENT CDTREE PARENT LEVEL10

DESC MANAGEMENT DEPARTMENT
DESC [email protected]
DESC FAX=567/78/12
DESC FOLDER=MGT/LOCAL REPORTS
DESC

%REPORT%, %REMARK%, %JOBNAME%, %ODATE%, %USER%, %REPORT-ID%

These fields are resolved from the corresponding report entry.

%MAIL_HOST%, %DSR_NAME%
These fields are resolved from the MAIL_HOST and DSR_NAME variables, defined
in the CTDSPARM member of the CTD PARM library.

Please note that the length of the CTDDS ATTRIBUTES field must not exceed 254
characters after the variables are resolved.

There are set of standard logical destinations that are loaded into the Permanent User File
during installation. For existing CTD environment these destination can be loaded by the
job FORMCTDS from the BASE INSTCTD library (submit the job through ICE 7.3 screen).

NOTE
The various destination types and the names of the default CTDDS Attributes for each
destination type are listed in member $$CTDSAT of the CONTROL-D OUTPARMS library.

In the example below, additional information about external destination DOCUMT

is displayed. This is an e-mail destination which requires an e-mail address (for
example, [email protected]) in the RECIPIENT field.

Chapter 2 Online Facilities 291

CONTROL-D External Destinations Screen

Figure 135 CONTROL-D External Destinations, Additional Information Example

---------------------- CONTROL-D EXTERNAL DESTINATIONS -------------- (U.CTDS)
COMMAND ===> SCROLL===> CRSR
O DEST TYPE DESCRIPTION
LASER1 LPR Laser Printer #1
DOCUMT Email Documentation Dept E-Mail
HOST 172.16.2.115 PORT 1948 CONVERT TO ASCII Y
CTDDS ATTRIBUTES SEND WITH CC N
HOST=Houston [email protected]
sender=DS subject=CTD
ds_banner= ds_title=
MKT FS Marketing File System
LASER2 LPR Laser Printer #2
HUMRES FS Human Resource File System
LAWDEPT Email Law Department E-mail
REMOTE FT Remote File Transfer
SALES Email Sales E-Mail
===== >>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<< ======

S SELECT A ADD INFO U UPDATE C COPY I INSERT D DELETE 18.02.37

Copy Confirmation Window

Specifying option C displays a confirmation window with the following fields:

Table 125 CONTROL-D External Destinations Copy Confirmation Window

Field Description
CONFIRM COPY Confirms whether or not to create a new external destination by
copying the existing entry. Valid values:

Y (Yes) Confirms that the external destination entry should be

copied.
N (No) No action is taken.
COPY TO DEST New external destination name to which the external destination entry
is copied.

292 CONTROL-D and CONTROL-V User Guide

 CONTROL-D External Destinations Screen

Figure 136 CONTROL-D External Destinations Copy Confirmation Window

---------------------- CONTROL-D EXTERNAL DESTINATIONS -------------- (U.CTDS)
COMMAND ===> SCROLL===> CRSR
O DEST TYPE DESCRIPTION
LASER1 LPR Laser Printer #1
DOCUMT Email Documentation Dept E-Mail
MKT FS +--------------------------+
LASER2 LPR | CONFIRM COPY : |
C HUMRES FS <----| COPY TO DEST : |
LAWDEPT Email +--------------------------+
REMOTE FT Remote File Transfer
SALES Email Sales E-Mail
===== >>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<< ======

S SELECT A ADD INFO U UPDATE C COPY I INSERT D DELETE 18.02.37

---------------------- CONTROL-D EXTERNAL DESTINATIONS -------------- (U.CTDS)
COMMAND ===> SCROLL===> CRSR
O DEST TYPE DESCRIPTION
DSR ctd_repo sending text reports to DSR
DSRHTML ctd_repo sending AFP/XEROX reports to DSR with trans HTML
DSRPDF ctd_repo sending AFP/XEROX reports to DSR with trans to PDF
DSRTXT ctd_repo sending AFP/XEROX reports to DSR with trans to TXT
FAX fax sending text reports to fax
FAXPCL fax sending AFP/XEROX reports to fax in PCL format
FAXPDF fax sending AFP/XEROX reports to fax in PDF format
LFS fs send text report to local file system
LFSHTML fs send AFP/XEROX reports to LFS in HTML format
LFSPDF fs send AFP/XEROX reports to LFS in PDF format
LFSTXT fs send AFP/XEROX reports to LFS in TXT format
MAIL email send text reports by e-mail
MAILATT email send reports as attacments
MAILHTML email send AFP/XEROX reports with transform. to HTML
MAILTXT email send AFP/XEROX reports by e-mail as text
===== >>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<< ======

S SELECT A ADD INFO U UPDATE C COPY I INSERT D DELETE 18.02.37

Chapter 2 Online Facilities 293

File Transfer Control for Sites With CONTROL-D/PC

Delete Confirmation Window

Entering option D displays a confirmation window with the following fields:

Table 126 CONTROL-D External Destinations Delete Confirmation Window

Field Description
CONFIRM DELETE Confirms whether or not to delete an existing external destination
entry. Valid values:

Y (Yes) Confirms that the external destination entry should be

deleted.
N (No) No action is taken.

Figure 137 CONTROL-D External Destinations Delete Confirmation Window

---------------------- CONTROL-D EXTERNAL DESTINATIONS -------------- (U.CTDS)
COMMAND ===> SCROLL===> CRSR
O DEST TYPE DESCRIPTION
LASER1 LPR Laser Printer #1
DOCUMT Email Documentation Dept E-Mail
MKT FS +--------------------+
D LASER2 LPR <----| CONFIRM DELETE : |
HUMRES FS +--------------------+
LAWDEPT Email Law Department E-mail
REMOTE FT Remote File Transfer
SALES Email Sales E-Mail
===== >>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<< ======

S SELECT A ADD INFO U UPDATE C COPY I INSERT D DELETE 18.02.37

File Transfer Control for Sites With

CONTROL-D/PC
CONTROL-D/PC is a software product that enables PC users to transfer
CONTROL-D reports to their PCs. The execution of this transfer process is monitored
and controlled by the Active Transfer file (ATF) on the mainframe. Details about this
process are described in the CONTROL-D/PC Administrator Guide.

The CONTROL-D File Transfer Control screen displays the status of all current
packets (reports for a specific user) that have been scheduled for transfer to a PC.

294 CONTROL-D and CONTROL-V User Guide

 File Transfer Control for Sites With CONTROL-D/PC

Packets are automatically created by a printing mission and included in the packet
list if the report had a status of WAIT PRINTING and a destination of CTDPC or
CTDPCPRT. Actual transfer to a PC is initiated by the PC user or by the File Transfer
monitor. For more information about the File Transfer monitor, see the IOA concepts
chapter and the CONTROL-D and CONTROL-V chapter, both in the INCONTROL for
z/OS Administrator Guide.

To enter the File Transfer Control screen, select option F on the IOA Primary Option
menu.

Figure 138 File Transfer Control Screen

----------------------- CONTROL-D FILE TRANSFER CONTROL ----------------------
COMMAND ===> SCROLL===> CRSR
O USER CREATED TRANSFERRED SIZE ------- STATUS --------------
MGT 08/08/00 8:00 08/08/00 9:00 6004 TRANSMITTED
MGT 08/08/00 8:00 6004 WAIT TRANSMISSION (T)
ACCT 08/08/00 8:57 10550 HELD TRANSMITTING
ACCT 08/08/00 8:57 3620 HELD WAIT TRANSMISSION
========= >>>>>>>>>>>>>>>>>>> BOTTOM OF PACKET LIST <<<<<<<<<<<<<<<<< =======

OPT: H HOLD D DELETE F FREE R RETRANSMIT P PRINT Z ZOOM I INDEX

Chapter 2 Online Facilities 295

CONTROL-D/PC Workflow

CONTROL-D/PC Workflow
Figure 139 CONTROL-D/PC Workflow

296 CONTROL-D and CONTROL-V User Guide

 Fields of the File Transfer Control Screen

Fields of the File Transfer Control Screen

Table 127 Fields of the Transfer Control Screen
Field Description
USER Name of the report recipient.
CREATED Date and time the packet was created by the printing mission. Date
format is mmddyy, ddmmyy or yymmdd, depending on the site
standard. Time format is hhmm.
TRANSFERRED Date and time the packet was transferred to the PC. Date and time
formats are the same as those for the CREATED field.
SIZE Size of the packet (in bytes).
STATUS Transfer status of the packet (see below).

Transfer Statuses
Valid transfer statuses are listed below. On terminals supporting color, each status
has its own associated color indicated after the status description.

NOTE
To change color defaults, see your INCONTROL administrator.

Table 128 Transfer Statuses of the File Transfer Control Screen

Status Explanation
INITIALIZING Packet is being created. If the creation process fails, this status may
remain. Normally, this status changes to WAIT TRANSMISSION or
TRANSMITTING. Blue or white.
WAIT Packet is waiting for the PC user to initiate the transfer. Color: Blue or
TRANSMISSION White.
TRANSMITTING Packet is currently being transferred. Color: Yellow.
TRANSMITTED Packet has already been transferred. Color: Green.
TRANSMISSION An error occurred during file transfer. Transfer not completed. Color:
ERROR Red.
PACKET TOO Packet size exceeded the limit set for the users reports in the Recipient
LARGE Tree. (For more information see Recipient Tree Definition in this
chapter of the guide.) Transfer is not attempted. Color: Pink.
DELETED Packet has been deleted by request. It is no longer accessible.
Color: Blue or White.

Chapter 2 Online Facilities 297

Options of the File Transfer Control Screen

The following states may appear as part of a status:

Table 129 States that may Appear as Part of a Status

State Description
HELD (Precedes the status.) The H (HOLD) option was specified for the
packet and the packet is in held state.
(T) (Follows the WAIT TRANSMISSION status.) Current time is outside
the defined time range during which file transfers are permitted. (This
time range is defined in the Recipient Tree see Recipient Tree
Definition Screen in this chapter of the guide.) The packet remains in
WAIT TRANSMISSION status until it is within the specified time
limits.

Options of the File Transfer Control Screen

To request one of the following options, specify the option in the O (Option) field and
press Enter.

Table 130 Options of the File Transfer Control Screen

Option Description
H (HOLD) Packet is placed in a held state (HELD precedes the regular status in
the STATUS field). Packet is not transferred until freed by the F
(FREE) option.
D (DELETE) Delete the packet. Only packets placed in held state (through the H
(HOLD) option) can be deleted.
F (FREE) Free a held packet.
R (RETRANSMIT) Retransfer the packet. This option can be used for already transmitted
packets or packets with a TRANSMISSION ERROR status.
P (PRINT) Display the Confirm Print window to allow immediate printing of the
packet. For more information see Report Printing later in this
chapter.
Z (ZOOM) Display the Zoom screen that zooms in on packet details and
describes the parameters of the packet.
I (INDEX) Display the Index screen that lists all reports belonging to the packet.

Transfer of Index Files

CONTROL-D/WebAccess Server for Windows supports using main index data in
the transferred reports. If the CONTROL-V Index to PC installation parameter
IXTOPC in member CTVPARM of the IOA PARM library is set to Y (Yes), main index
data is included in the transfer packets.

298 CONTROL-D and CONTROL-V User Guide

 SHOW Command

SHOW Command
The SHOW command displays the Show Option window that allows you to specify
display selection criteria. Only packets meeting the specified selection criteria are
included in the File Transfer Control screen. Specify the selection criteria and press
Enter.

Figure 140 File Transfer for Control Show Option Window

----------------------- CONTROL-D FILE TRANSFER CONTROL --------------------(F)
COMMAND ===> +-----------------------------------------------------+
O USER CREATED | PLEASE SELECT SHOW OPTION |
========= >>>>>>>>>>>> | |
MGT 08/08/00 8 | USER |
MGT 08/08/00 8 | |
ACCT 08/08/00 8 | ----- STATUS -------- |
ACCT 08/08/00 8 | WAIT TRANSMISSION Y |
========= >>>>>>>>>>>> | TRANSMITTING Y |
| TRANSMITTED Y |
| TRANSMISSION ERROR Y |
| PACKET TOO LARGE Y |
| DELETED Y |
+-----------------------------------------------------+

OPT: H HOLD D DELETE F FREE R RETRANSMIT P PRINT Z ZOOM I INDEX

Selection criteria are:

Table 131 File Transfer for Control Show Option Window Selection Criteria
Criteria Description
USER User name. Display only the packets of the specified users. User names
act on a prefix basis. Refer to Prefixing earlier in this chapter.
Multiple users may be specified by pressing the Tab key after each
entry. If the USER field is blank, packets for all users are displayed.
STATUS All status selection criteria are Y/N parameters:

Y (Yes) Include packets with this status in the display.

N (No) Do not include packets with this status in the display.

The following statuses are valid selection criteria:

WAIT TRANSMISSION
TRANSMITTING
TRANSMITTED
TRANSMISSION ERROR
PACKET TOO LARGE
DELETED

Chapter 2 Online Facilities 299

Report Printing

Report Printing
Option P opens the Confirm Print window that enables you to print the selected
packet.

Figure 141 File Transfer Control Screen Confirm Print Window

----------------------- CONTROL-D FILE TRANSFER CONTROL --------------------(F)
COMMAN +-----------------------------------------------------------+ ===> CRSR
O USER | PLEASE CONFIRM PRINT | --------
MGT | |
MGT | CONFIRM (Y/N) |
ACCT | CLASS |
ACCT | DEST | N
====== | WRITER | < ======
| COPIES |
+-----------------------------------------------------------+

OPT: H HOLD D DELETE F FREE R RETRANSMIT P PRINT Z ZOOM I INDEX

The Confirm Print window contains the following fields:

Table 132 File Transfer Control Screen Confirm Print Window Fields
Field Description
CONFIRM Whether or not the packet should be printed.

Y (Yes) Print the packet.

N (No) Do not print the packet.

CLASS Name of the output class in which the packet should be printed.
DEST Remote destination (node and userid) where the packet should be
printed (or blank for the main printer).
WRITER Name of an external writer. (If your data center is using TS-PRINT, this
option is usually used to designate the VTAM name of the printer.)
COPIES Number of copies to print. This number cannot be greater than the
maximum defined for the report in the report decollating mission.

300 CONTROL-D and CONTROL-V User Guide

 Packet Zoom Screen

Packet Zoom Screen

The Packet Zoom screen is displayed when the Z (Zoom) option is entered on the File
Transfer Control screen. The Packet Zoom screen zooms in on packet details it
describes the specific parameters of the packet.

Figure 142 CONTROL-D Packet Zoom Screen

-------------------------- CONTROL-D PACKET ZOOM SCREEN ------------------(F.Z)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
USER MGT CREATED 08/08/00 18:54 SIZE 46952
STATUS WAIT TRANSMISSION
===========================================================================
RETENTION PERIOD (DAYS) MF 006 PC 006
TRANSFER PERIOD (HHMM) FROM 0000 UNTIL 2400
===========================================================================
LAST TRANSFER START / / 0:00 NUMBER OF RETRIES 000
LAST TRANSFER END
===========================================================================
CDAM FILE I4B.D3M.D3BPRINT.J01151.D3351854.S01.N014300 EXTENTS 01
INDEX FILE I4B.D3M.D3BPRINT.J01151.D3351854.IND.N014300
PC PATH
===========================================================================
IMMEDIATE PRINT CLASS O COPIES 01
======= >>>>>>>>>> END OF TRANSFERRED PARAMETERS FOR THIS REQUEST <<<<<<< =====

ENTER SAVE TO UPDATE CHANGES. 19.09.53

Fields of the Packet Zoom Screen

Table 133 Fields of the CONTROL-D Packet Zoom Screen (part 1 of 2)

Field Description
USER Name of the report recipient.
CREATED Date and time the packet was created by the printing mission. Date
format is mmddyy, ddmmyy, or yymmdd, depending on the site
standard. Time format is hhmm.
SIZE Size of the packet (in bytes).
STATUS Transfer status of the packet (see below).
RETENTION Retention period on both the mainframe and PC. Parameters include:
PERIOD (DAYS)
MF Number of days to keep the packet ready for transmission on
the mainframe. Valid range: 000 999.
PC Number of days to keep the user report on the PC. Valid
range: 000 999.

Chapter 2 Online Facilities 301

Packet Index Screen

Table 133 Fields of the CONTROL-D Packet Zoom Screen (part 2 of 2)

Field Description
TRANSFER Time interval during which transfer of reports from mainframe to PC
PERIOD (HHMM) is allowed.
FROM hhmm
UNTIL hhmm
LAST TRANSFER Date and time that the last file transfer began.
START
LAST TRANSFER Date and time that the last file transfer ended.
END
NUMBER OF Number of times file transfer was attempted.
RETRIES
CDAM FILE Mainframe CDAM file of the packet.
EXTENTS Number of CDAM file extents.
INDEX FILE Index of the CDAM file names.
PC PATH PC path to which reports are downloaded (drive:\directory).
IMMEDIATE Name of the output class to which the packet should be printed.
PRINT CLASS
COPIES Number of copies to print. This number cannot be greater than the
maximum defined for the report (in the report decollating mission
parameters).

Modifying Parameters in the Packet Zoom Screen

Some fields on the screen can be modified.

To modify packet parameters in the Transfer file, the packet must be in HELD state
before you enter the Packet Zoom screen to make the desired changes.

Exiting the Packet Zoom Screen

To save changes made in the Packet Zoom screen, type the command SAVE and press
Enter.

To return to the File Transfer Control screen without saving changes, press END
(PF03/PF15). Any changes made to packet data are not kept.

Packet Index Screen

The Packet Index screen is displayed when option I (Index) is specified in the File
Transfer Control screen. The Packet Index screen lists all reports belonging to a
specific packet.

302 CONTROL-D and CONTROL-V User Guide

 Packet Index Screen

Figure 143 CONTROL-D Packet Index Screen

---------------------------- CONTROL-D PACKET INDEX ----------------------(F.I)
COMMAND ===> SCROLL===> CRSR
JOBNAME JOBID REPORT NAME CLASS COPIES DATE TIME PAGES LINES
MGT 00939 EMPCTDPC 104 O 1 08/08/00 18:49 3 45
MGT 00939 EMPCTDPC 114 P 1 08/08/00 18:49 1 12
MGT 00939 EMPCTDPC 124 T 1 08/08/00 18:49 1 4
MGT 01268 EMPCTDPC 14 O 1 08/08/00 18:42 3 45
MGT 01268 BNKCTDPC 24 P 1 08/08/00 18:42 1 12
MGT 01268 BNKCTDPC 34 T 1 08/08/00 18:42 1 4
MGT 01271 BNKCTDPC 44 O 1 08/08/00 18:44 3 45
MGT 01271 BNKCTDPC 54 P 1 08/08/00 18:44 1 12
MGT 01271 INVCTDPC 64 T 1 08/08/00 18:44 1 4
MGT 01276 INVCTDPC 74 O 1 08/08/00 18:47 3 45
MGT 01276 INVCTDPC 84 P 1 08/08/00 18:47 1 12
MGT 01276 INVCTDPC 95 T 1 08/08/00 18:47 1 4
========= >>>>>>>>>>>>>>>>>>> BOTTOM OF REPORT LIST <<<<<<<<<<<<<<<<<<< =======

ENTER END TO EXIT 09.39.17

Use the scrolling conventions to scroll the Packet Index screen forward and
backward.

To exit the screen, press END (PF03/PF15).

Fields of the Packet Index Screen

The Packet Index screen provides the following information about each report in a
packet:

Table 134 Fields of the CONTROL-D Packet Index Screen (part 1 of 2)

Field Description
JOBNAME Name of the job that creates the report.
JOBID JES job number of the job that created the report.
REPORT NAME First 20 characters of the name of the report (as defined in the report
decollating mission parameters).
CLASS Printing class of the output.
COPIES Copy count to be used when the report is printed. Valid values are 0
up to the maximum number allowed, and DFT. The maximum and
default (DFT) number of copies is set in the report decollating mission
parameters by authorized personnel.
DATE Date that the report was decollated.
TIME Time that the report was decollated.

Chapter 2 Online Facilities 303

Tracking and Control Active Missions Screen

Table 134 Fields of the CONTROL-D Packet Index Screen (part 2 of 2)

Field Description
PAGES Number of pages in the report.
LINES Number of lines in the report.

Tracking and Control Active Missions Screen

The CONTROL-V Active Missions screen displays the status of all missions in the
Active Missions Environment. The Active Missions Environment contains all
missions that have executed recently, are about to execute in the near future, or are
currently executing. On the screen you can view the status of the missions and
modify the missions scheduling and execution parameters. The SHOW option is
used to modify selection criteria online.

To enter the Active Missions Environment Screen, select option A on the IOA
Primary Option menu.

Figure 144 Active Missions Environment Screen

------------------- CONTROL-D/V ACTIVE MISSIONS ENVIRONMENT ----------------(A)
COMMAND ===> SCROLL===> CRSR
O NAME ODATE TYP OWNER ------------------STATUS ------------------ UP
INTR0002 080800 REP M331 WAITING FOR JOB
GPLIR17A 080800 REP M335 J06015 ENDED "OK"
GPLIR18 080800 REP M335 WAIT SCHEDULE
PRDKPL01 080800 REP M01 J06029 ENDED "OK"
PRDKPL02 080800 REP M01 J06095 ENDED "OK"
PRDKPL2W 080800 REP M01 J06156 ENDED "OK"
PRDDRPT1 080800 REP M01 J06072 ENDED "OK"
PRDDRPT2 080800 REP M01 J06435 ENDED "OK"
PLRPT010 080800 REP M08A J07028 DECOLLATING
MTRPTU6C 080800 REP MT12 J06871 ENDED- NOT "OK"
EBDMM4D 080800 REP M24 J07019 ENDED "OK"
SPFORM1 080800 PRT M02 HELD WAIT SCHEDULE
BKP0031D 080800 BKP M02 BACKUP IN PROCESS
RST0060M 080800 CRS M02 WAIT SCHEDULE
CBJBRUN 080800 REP M25A WAIT SCHEDULE
SPFORM2 080800 PRT M02 PRINTING ON U1004
STD 080800 PRT M02 PRINTING ON U1002
BKP0180D 080800 BKP M02 WAIT PROCESS
PRODYHRP 080800 REP M02A J07031 DECOLLATING
PRODYH72 080800 REP M02A WAIT SCHEDULE
OPT: ? WHY H HOLD D DELETE F FREE L LOG Z ZOOM R RERUN P PRINT CONTROL 12.01.11

NOTE
It is assumed that the user wants to see the most recently ordered missions first. Therefore,
upon entry to the Active Missions screen, the missions at the bottom of the Active Missions
list are displayed.

304 CONTROL-D and CONTROL-V User Guide

 Tracking and Control Active Missions Screen

Use the scrolling conventions to scroll the Active Missions list forward and
backward.

Exit the Active Missions screen by pressing END (PF03/PF15).

On color terminals, missions are color coded by status. The default color for various
statuses is:

Table 135 Default Colors for Active Missions Screen

Status Description
Blue or White Missions that have not begun processing (that is, waiting to be
scheduled or processed)
Yellow Missions that have begun but not finished executing (for example,
executing, waiting for a job, and so on)
Red Missions that ended NOTOK
Green Missions that ended OK
Pink Missions requiring special operator action (for example, In Queue
Waiting for Printer)

See your INCONTROL administrator to change the color definitions.

Chapter 2 Online Facilities 305

Format Commands of the Active Missions Screen

Format Commands of the Active Missions Screen

Table 136 Commands of the Active Missions Screen
Command Description
GROUP Alternately displays and hides the GROUP. Type the command in the
COMMAND field, and press Enter. When displayed, the name of the
group appears after the mission status.
CATEGORY Alternately displays and hides the CATEGORY. Type the command in
the COMMAND field and press Enter. When displayed, the name of
the category appears after the mission status.
DESC Alternately displays and hides the DESCRIPTION. Type the
command in the COMMAND field and press Enter. When displayed,
the description appears after the mission status. Only the first
description line of the mission is available in the Active Missions
screen.

Fields of the Active Missions Screen

The information displayed for each mission includes:

Table 137 Fields of the Active Missions Screen (part 1 of 2)

Field Description
O Option to be activated on the mission.
NAME The mission name for report decollating missions. This is usually the
job name.
ODATE Original scheduling date of the mission. For more information, see
Date Definition Concepts on page 73.
TYP Mission types:

REP Report decollating mission

ERP Emergency report decollating mission
MIG Migration mission
EMG Emergency migration mission
PRT Printing mission
EPR Emergency printing mission
BKP Backup mission
EEK Emergency backup mission
RST Restore mission
ERS Emergency restore mission
CRS Cyclic restore mission
OWNER User ID (owner) of the mission, for security purposes.
Monitor Status Indicates whether the CONTROL-V monitor is UP or DOWN.
STATUS Mission status (see Table 138).

306 CONTROL-D and CONTROL-V User Guide

 Fields of the Active Missions Screen

Table 137 Fields of the Active Missions Screen (part 2 of 2)

Field Description
GROUP Group name of the mission (see the description of the GROUP
command in Table 136).
CATEGORY Category of the mission (see the description of the CATEGORY
command in Table 136).
DESC Description of the mission (see the description of the DESC command
in Table 136).

The information displayed in the STATUS field includes the following:

Table 138 Mission Statuses (part 1 of 3)

Status Description
WAIT SCHEDULE The mission (migration, printing, backup, restore) is waiting to be
scheduled.
WAIT PROCESS The report decollating mission is waiting to be scheduled.
DECOLLATING The report decollating mission is currently decollating a report.
ENDED OK Mission finished executing OK.
ENDED OK NO There are no reports waiting to be decollated by this mission. The
REPORTS report decollating mission finished executing OK.
ENDED OK The mission finished executing OK but encountered some problems.
WITH WARNINGS Use option L to determine the reasons.
DECOLLATED OK The report decollating mission finished decollating OK.
ENDED NOT OK Mission ended NOTOK. Use option L to determine the reason.
DECOLLATED The report decollating mission finished decollating NOTOK. Use
NOT OK option L to determine the reason.
HELD Mission is in hold status.
REQUESTED A hold request has been issued for the mission but the request has not
HELD yet been accepted by the monitor.
REQUESTED FREE A free request has been issued for a held mission but the request has
not yet been accepted by the monitor.
REQUESTED A rerun request has been issued for the mission but the request has not
RERUN yet been accepted by the monitor.
DELETED The mission order has been deleted by an authorized user.
REQUESTED Mission parameters have been changed via the Zoom option but the
CHANGE request has not yet been accepted by the monitor.
TO BE The mission is active during the time the New Day procedure is
SUSPENDED activated. The mission (or current cycle of a cyclic mission) finishes
executing after the New Day procedure has ended.
SUSPENDED A mission, which was active as the New Day procedure executed,
finished executing after the New Day procedure ended and the
CONTROL-V monitor was reactivated. This mission (or additional
cycles of a cyclic mission) is not processed further and cannot be rerun.

Chapter 2 Online Facilities 307

Fields of the Active Missions Screen

Table 138 Mission Statuses (part 2 of 3)

Status Description
GENERIC The report decollating mission is of GENERIC type, that is, triggered
by the appearance of job output on specified classes. For details see
GENERIC: General Parameter on page 524.
WAITING FOR JOB The report decollating mission is eligible for processing and is
currently waiting for a job with the same name as the decollating
mission to appear on the JES output queue. If there is already a job on
the output queue with the same name and the mission remains in the
WAITING FOR JOB status, it means that CONTROL-V has already
processed the job, and is currently waiting for a new job (with the same
name).

Search the Active Missions file for a report decollating mission for the
same job name and the same job ID as the job on spool.

This mission is used by CONTROL-V as an identifier that the job has

already been decollated. If you want to force CONTROL-V to decollate
the same job again, place this mission (the one that ended) in HOLD
status.a

For a GENERIC report decollating mission, job output is searched for

only in the classes specified in CONTROL-D installation parameter
GENCLAS. Therefore, a generic mission can be in WAITING FOR JOB
status even if an output for the job exists on the spool in another class.
WAITING FOR The printing mission is eligible for printing, but all active printers are
PRINTER busy (that is, printing). (If no printers have been opened, refer to the
CONTROL-D and CONTROL-V chapter of the INCONTROL for z/OS
Administrator Guide for instructions.) If all printers are busy,
CONTROL-V waits until a printer is free and then lets the highest
priority printing mission print.
IN QUEUE This printing mission is waiting for an available printer (as explained
WAITING FOR above). It is the first one to start executing when a printer is available.
PRINTER
PRINTING A printing mission is being prepared for printing.
INITIALIZATION
INITIALIZING
PRINTING PLAN
BUILDING PRINT The printing mission is currently preparing the printing plan (that is,
PLAN determining which reports to print and the sort order). This status
remains until CONTROL-V begins putting reports on spool.
PRINTING ON dest The printing mission is currently printing to the specified local printer
destination (or JNAME under JES3).
PRINT POST Printing finished. Post-processing parameters are currently being
PROCESSING executed.
HOLD IN A hold request has been issued for a printing mission while the
PROCESS mission is printing. The mission stops printing at the end of the current
user report.

308 CONTROL-D and CONTROL-V User Guide

 Specifying Retrieval Criteria

Table 138 Mission Statuses (part 3 of 3)

Status Description
(RESTARTED) A held printing mission has been restarted (by a FREE command) and
continues to print from the point at which printing was held.
BACKUP IN A backup mission is currently executing.
PROCESS
RESTORE IN A restore mission is currently executing.
PROCESS
MIGRATE IN A migration mission is currently executing.
PROCESS
a
A feature of the WAITING FOR JOB status enables you to cause the same job output to be
decollated again by entering the job ID of the job on spool in the JOBID field of the report
decollating mission.

Specifying Retrieval Criteria

Different mission retrieval criteria can be specified by using the SHOW command.
Type SHOW on the command line and press Enter, or press PF02/PF14. A Show
Option window is displayed. Change the selection criteria and press Enter. Only
missions conforming to the selection criteria are displayed.

Figure 145 Active Missions Screen Show Option Window

------------------- CONTROL-D/V ACTIVE MISSIONS ENVIRONMENT ----------------(A)
COMMAND ===> +----------------------------------------------------------+
O NAME ODATE | PLEASE SELECT SHOW OPTION |
INTR0002 050500 | MISNAME |
GPLIR17A 050500 | CATEGORY |
GPLIR18 050500 | |
PRDKPL01 050500 | IN PROCESS Y | ENDED Y | STATE Y |
PRDKPL02 050500 | ------------------------------------------------------ |
PRDKPL2W 050500 | WAIT SCHEDULE Y | ENDED "OK" Y | FREE Y |
PRDDRPT1 050500 | WAIT FOR JOB Y | NOT "OK" Y | HELD Y |
PRDDRPT2 050500 | WAIT FOR PRNTR Y | | ON REQUEST Y |
PLRPT010 050500 | EXECUTING Y | | DELETED N |
MTRPTU6C 050500 | PRINTING Y | | |
EBDMM4D 050500 | OTHER Y | | |
SPFORM1 050500 | ===== TASK TYPE ===== |
BKP0031D 050500 | REP PRT BKP/MIG RST EMR NOEMR CYC NOCYC |
RST0060M 050500 | Y Y Y Y Y Y Y Y |
CBJBRUN 050500 | GROUP |
SPFORM2 050500 | COND NAME |
STD 050500 | COND TYPE: IN Y OUT Y COND Y |
BKP0180D 050500 | USERID |
PRODYHRP 050500 +----------------------------------------------------------+
PRODYH72 050500
OPT: ? WHY H HOLD D DELETE F FREE L LOG Z ZOOM R RERUN P PRINT CONTROL 12.31.09

The direction of the search when you exit the Show Option window can be specified.
If you press:

Chapter 2 Online Facilities 309

Specifying Retrieval Criteria

Enter, the search starts with the mission at the top of the screen and continues
downward.

PF07/PF19 (UP), the search starts at the top of the Active Missions list and continues
downward.

PF08/PF20 (DOWN), the search starts at the bottom of the Active Missions list and
continues upward.

NOTE
The selection criteria marked with the symbol P act on a prefix basis. For example, entering D4
in the MISNAME field retrieves missions whose name starts with D4.

The available selection criteria are:

Table 139 Active Missions Screen Show Option Window Search Criteria (part 1 of 2)
Criteria Description
MISNAMEP Show only missions with the specified names. A maximum of five
different names (either job name or mission name) can be specified.
CATEGORYP Show only missions of the specified categories. A maximum of two
different categories can be specified.
MISSION STATUS Show only missions which conform to the status selection criteria.
Mark the wanted statuses Y and the unwanted statuses N. Status
selection criteria:
IN PROCESS If marked Y, all missions that have not yet finished and are being
processed are displayed. If marked N, only completed missions are
displayed.

WAIT SCHEDULE Missions waiting for scheduling or

decollation.
WAIT FOR JOB Report decollating missions waiting for output.
WAIT FOR PRINTR Printing missions waiting for available
printer.
EXECUTING Decollating.
PRINTING For printing missions.
OTHER All other in-process statuses.
ENDED If marked Y, all completed missions are displayed. If marked N, only
missions in process are displayed.

ENDED OK Missions that ended OK.

NOT OK Missions that ended NOTOK.

310 CONTROL-D and CONTROL-V User Guide

 Options of the Active Missions Screen

Table 139 Active Missions Screen Show Option Window Search Criteria (part 2 of 2)
Criteria Description
STATE If marked Y, the following status criteria are matched to determine
whether or not a mission is displayed.

FREE, HELD, DELETED Mission state.

ON REQUEST A request for change in mission status has been
issued by a CONTROL-V user but the request has not yet been
accepted by the monitor.
TASK TYPE Enter Y to include or N to exclude the following:

REP Report decollating mission

PRT Printing mission
BKP/MIG Backup and migration missions
RST Restore mission
EMR Emergency mission
NOEMR Regular (non-emergency) mission
CYC Cyclic mission
NOCYC Regular (non-cyclic) mission
GROUPP Show only missions of the specified groups. Two different groups can
be specified.
COND NAMEP An additional cross reference for all missions that have a specified
prerequisite condition. Two prerequisite condition names can be
specified.
COND TYPE Enter Y to search for or N to not search for:

INPrerequisite conditions specified in the IN field.

OUTPrerequisite conditions specified in the OUT field.
CONDPrerequisite conditions specified in ON . . . . DO COND
statements.
USERIDP Show only missions of the specified user IDs. A maximum of five user
IDs can be specified.

Options of the Active Missions Screen

To request one of the following options, specify the option in the O (Option) field to
the left of the mission name and press Enter:

Chapter 2 Online Facilities 311

Why Screen

Table 140 Options of the Active Missions Screen

Option Description
? (WHY) Why does the mission wait for scheduling or decollation? The Why
screen (described below), which shows the reasons for WAIT
SCHEDULE and WAIT PROCESS statuses, is displayed.
H (HOLD) Hold the mission. CONTROL-V operations concerning the mission are
held. The HOLD request is recorded in the IOA Log file. The status of
the mission is changed to REQUESTED HELD. If the monitor is active,
the status changes to HELD after a few seconds. In some cases, a
HOLD request may be rejected by the monitor.
D (DELETE) Delete the mission. CONTROL-V only allows deletion of WAIT
SCHEDULE (WAIT DECOLLATION) missions, or missions that have
finished executing. To DELETE a mission, the mission must be in the
HELD status. The DELETE request is recorded in the IOA Log file.
F (FREE) Free a held mission. All CONTROL-V operations concerning the
mission are freed (that is, resumed). The FREE request is recorded in
the IOA Log file. The status of the mission is changed to REQUESTED
FREE. If the monitor is active, the FREE request is accepted after a few
seconds.
L (LOG) The IOA Log screen (described later in this chapter) is displayed
showing all IOA Log file messages for the specified mission.
Z (ZOOM) Zoom in on mission details. The Zoom screen (described later in this
chapter) is displayed.
R (RERUN) Rerun the mission. (For more information see the Rerun Option later
in this chapter.)
P (PRINT For printing missions only: Print Control (described later in this
CONTROL) chapter) allows you to print part of a bundle, to reprint all or part it,
and to monitor and control the printing process as the bundle prints.

Why Screen
The Why screen is displayed when option ? (WHY) is entered on the Active Missions
Screen. The Why screen shows the reasons for WAIT SCHEDULE and WAIT
PROCESS statuses.

312 CONTROL-D and CONTROL-V User Guide

 Why Screen

Figure 146 Active Missions Why Screen

------------------------- STD IS WAITING FOR: -----------------------(A.?)
COMMAND ===> SCROLL===> CRSR
OPT DESCRIPTION
TIME LIMIT FROM 0100 UNTIL 0700
CONDITION PRODL-REPORTS-READY ODATE 0502
CONDITION PRODB-REPORTS-READY ODATE 0502
======= >>>>>>>>>>>>>>>>> END OF "WHY" LIST <<<<<<<<<<<<<<<< ========

OPTION: A ADD CONDITION 23.10.40

If the list is longer than one page, use the scrolling PFKeys to scroll forward and
backward on the Why screen.

To return to the Active Missions screen, press END (PF03/PF15).

The possible WHY reasons are:

NOTHING MISSION WILL BE ACTIVATED SOON (IF CONTROL-V

MONITOR IS ACTIVE)
IN HOLD STATE
TIME LIMIT FROM hhmm UNTIL hhmm
NEXT CYCLIC RUN FROM hhmm
CONDITION condition-name ODATE date

where

condition-name is the prerequisite condition required by the mission.

date is the original scheduling date (in mmdd or ddmm format, depending on
the site standard).

Adding Conditions in the Why Screen

If the Why screen indicates that a job is waiting for prerequisite conditions, the
indicated conditions can be manually added from the Why screen by entering option
A (Add Condition) in the OPT (Option) field next to the condition.

Specify option A for every condition to be added, and press Enter.

Chapter 2 Online Facilities 313

Why Screen

When adding conditions, a confirmation window may be displayed depending on

User profile customization:

By default, when option A is specified in the Why screen, a confirmation window is

displayed only when the conditions date reference contains the generic characters
**** or $$$$. Addition of conditions without generic date references is performed
without confirmation from the user.

If, however, the User profile has been customized accordingly, the following
confirmation window is always displayed when option A is specified:

Figure 147 Active Mission Why Screen Add Confirmation Window

------------------------- PRUPDT02 IS WAITING FOR: -----------------------(A.?)
COMMAND ===> SCROLL===> CRSR
OPT DESCRIPTION +-------------------------+
| CONFIRM MMDD 0909 |
A CONDITION PROD-PRUPDT03-GO <--------| ASK FOR EACH ONE Y |
A CONDITION PROD-PRUPDT03-CHECK +-------------------------+
A CONDITION PROD-PRUPDT03-FLAG ODATE 0909
====== >>>>>>>>>>>>>>>>>>> END OF "WHY" LIST <<<<<<<<<<<<<<<< =====

OPTION: A ADD CONDITION 18.15.36

Fill in or modify the fields of the confirmation window as follows, and press Enter:

Table 141 Active Mission Why Screen Add Confirmation Window Fields (part 1 of 2)
Field Description
date Date of the listed condition.

If the date reference of the listed condition contains the generic characters
**** or $$$$, the date field of the window is unprotected and you must
explicitly enter the date in the date field.

If the date reference of the listed condition is a specific date (in either
mmdd or ddmm format, depending on the standard in use at the site), the
date field of the window is protected and its value cannot be changed.

314 CONTROL-D and CONTROL-V User Guide

 Mission Log Screen

Table 141 Active Mission Why Screen Add Confirmation Window Fields (part 2 of 2)
Field Description
CONFIRM Confirms whether or not to process the Add Condition request. Valid
values are:

Y (Yes) Process the Add Condition request.

N (No) Cancel the request.
ASK FOR This line is displayed only if more than one Add Condition is requested. It
EACH ONE determines whether or not individual confirmation is required for each
Add Condition request. Valid values are:

Y (Yes) Individual confirmation is required for each Add Condition

request. The specified CONFIRM value (Y or N) applies only to the
current Add Condition request.

N (No) Individual confirmation is not required for each Add

Condition request. The specified CONFIRM operation is applied to all
Add Condition requests. (If CONFIRM is Y, all Add Condition
requests are processed. If CONFIRM is N, no Add Condition request is
processed.)

Mission Log Screen

The Mission Log screen is displayed when the L (Log) option is entered on the Active
Missions screen. The Mission Log screen shows all IOA Log file messages of the
specified mission.

Figure 148 Active Missions Messages Log Screen

-------------------- LOG MESSAGES FOR MISSION(S) PRDRPT10 ----------------(A.L)
COMMAND ===> SCROLL===> CRSR
SHOW LIMIT ON ==> DATE 080800 - 080800
DATE TIME ODATE USERID CODE ------ M E S S A G E --------------------
080800 013343 080800 M33A CTD511I REP PRDRPT10 ODATE 090998 PLACED ON
ACTIVE MISSIONS FILE-
080800 013347 080800 M33A SCD203I REP PRDRPT10 ELIGIBLE FOR PROCESSING
080800 013348 080800 M33A REP267I PRDRPT10 PRDRPT10/JOB02292 DECOLLATION
FROM SPOOL STARTED
080800 014015 080800 M33A REP251I REP PRDRPT10 PRDRPT10/JOB02292
DECOLLATION ENDED "OK"
080800 014015 080800 M33A SCD208I REP PRDRPT10 PROCESSING ENDED "OK"
======== >>>>>>>>>>>>>>>> NO MORE LOG MESSAGES <<<<<<<<<<<<<<<< ========

CMDS: SHOW, GROUP, CATEGORY, SHPF 13.14.26

Chapter 2 Online Facilities 315

Zoom Screens

Usage of the Mission Log screen is explained later in this chapter (see IOA Log
Facility).

To return to the Active Missions screen, press END (PF03/PF15).

Zoom Screens
The Zoom screen is displayed when the Z (Zoom) option is entered on the Active
Missions screen. The Zoom screen zooms in on mission details it describes the
specific parameters of the mission.

A different Zoom screen appears according to mission type:

Table 142 Active Missions Zoom Screen Types

Type Description
Decollating Similar to the Report Decollating Definition screen.
Printing Similar to the Printing Mission Definition screen.
Migration Data for stage 01 migration (mission type MIG) and for other
migrations stages (mission type MSM) are displayed in separate Zoom
screens according to mission type.
Backup Similar to the Backup Mission Definition screen.
Restore Similar to the Restore Mission Definition screen.

Some of the displayed parameters can be modified. Information on most Zoom screen
fields can be found in the pages of this chapter which explain the corresponding
Mission Definition fields.

Sample Zoom screens for the various types of missions are illustrated on the
following pages. Zoom screen fields that do not appear on the Mission Definition
screen are labeled in the sample screens and defined below:

Table 143 Zoom Screen Fields Not on the Mission Definition Screen (part 1 of 2)
Field Description
JOB (See Figure 149) Job number in JES (only for report decollating missions and only
after decollation).
STARTED (See Printing mission start time.
Figure 151)
TIMESTAMP (B1) A number assigned to the migration or backup or restore ANALYZE
(See Figure 153) step to uniquely identify the mission.

316 CONTROL-D and CONTROL-V User Guide

 Zoom Screens

Table 143 Zoom Screen Fields Not on the Mission Definition Screen (part 2 of 2)
Field Description
ODATE (C) (See Original scheduling date assigned to the mission.
Figure 151)
NEXT TIME (D) (See Cyclic missions that use the INTERVAL option the next possible
Figure 151) execution time.

The values assigned to the prerequisite condition date references (via IN and OUT
parameters and DO COND statements) are the real date values derived from symbols
of the mission parameters, such as ODAT and PREV. Only specific dates (or STAT,
****, $$$$) can be used as prerequisite condition date references.

Figure 149 Report Decollating Mission Zoom

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(A.Z)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE REPORTS
===========================================================================
IN PLRPT010-ENDED-OK 0909
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL 000 PRIORITY
DSN MAXWAIT 00
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URG R
MSG ==== REPORT DECOLLATION FOR PLRPT010 ENDED N O T O K ====
SHOUT WHEN TO URG
MSG
===========================================================================
DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES 10
===========================================================================
SET = %% = C CS
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT Y REF NXT N CT AND/OR O
ENTER SAVE TO UPDATE CHANGES. 14.12.30

Chapter 2 Online Facilities 317

Zoom Screens

Figure 150 Migration Mission Zoom Screen

---- CONTROL-V CATEGORY MLMIG01 MIG MISSION MLMIG01 --------(A.Z)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY MLMIG01 MISSION MLMIG01
OWNER N54A TASKTYPE MSM GROUP
TIMESTAMP 14431179 ODATE 291298 MAXWAIT 00
DESC
===========================================================================
IN
TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
OUT
SHOUT WHEN TO URGN
MSG
===========================================================================
RETENTION DAYS 01096 FORCE N SECONDARY MICLIM INTERVAL NEXT TIME
CENTERA RETENTION CLASS
===========================================================================
STAGE 01 PRIMARY MEDIA NAME DISK AGE 0030 REFRESH EVERY
PREFIX
SECONDARY MEDIA NAME REFRESH EVERY
STAGE 02 PRIMARY MEDIA NAME FTK1 AGE 0060 REFRESH EVERY
FSET MAGDISK VSET MAGDISK
SECONDARY MEDIA NAME REFRESH EVERY
ENTER SAVE TO UPDATE CHANGES 08.49.17

In the Migration Mission Zoom screen, parameters FORCE, PREFIX, FSET and VSET
can be changed.

Figure 151 Printing Mission Zoom Screen

---- CONTROL-D CATEGORY DAILY PRT MISSION STD --------(A.Z)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
STARTED ODATE 090998 MAXWAIT 00
WRITER OPTION
DESC PRINTING MISSION FOR ALL STANDARD FORM REPORTS
===========================================================================
INCLUDE USER BRANCH25
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-DECOL TIME E-USER DEFINED
ENTER SORT SEQ : 1,2,3,4,5,6,7
===========================================================================
IN
TIME FROM TO NOT LATER THAN PRIORITY
ON PAGE# ON LINE# INTERVAL NEXT TIME
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
ENTER SAVE TO UPDATE CHANGES. 13.05.38

318 CONTROL-D and CONTROL-V User Guide

 Zoom Screens

NOTE
If CONTROL-D for Distributed Systems is installed, reports can be distributed to a Unix or
Windows NT environment by setting the first field of parameter OVERIDE DEST (the node)
to CTDS. For details see CONTROL-D for Distributed Systems on page 286.

Figure 152 Backup Mission Zoom Screen

---- CONTROL-D CATEGORY DAILY BKP MISSION BKP0007D --------(A.Z)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION BKP0007D
OWNER M22 TASKTYPE BKP GROUP
TIMESTAMP 14593226 ODATE 080800 MAXWAIT 00
DESC BACKUP REPORTS FOR 7 DAYS
===========================================================================
IN OP-START-BACKUP-007D 0909
TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
KEEP DAYS 0007 GENERATIONS INTERVAL NEXT TIME
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG BACKUP MISSION BKP0007D ENDED NOTOK
SHOUT WHEN TO URGN
MSG
======= >>>>>>>>>>>>>>> END OF BACKUP MISSION PARAMETERS <<<<<<<<<<<<<<<< =====

ENTER SAVE TO UPDATE CHANGES 13.47.09

Figure 153 Restore Mission Zoom Screen

---- CONTROL-D CATEGORY DAILY RST MISSION RST0060M --------(A.Z)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION RST0060M
OWNER M22 TASKTYPE RST GROUP
TIMESTAMP 23050490 ODATE 080800 MAXWAIT 00
DESC RESTORE REPORTS EVERY 60 MINUTES
===========================================================================
IN
TIME FROM TO NOT LATER THAN PRIORITY
INTERVAL 060 NEXT TIME 1405
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG RESTORE MISSION RST0060M ENDED NOTOK
SHOUT WHEN TO URGN
MSG
======= >>>>>>>>>>>>>>> END OF RESTORE MISSION PARAMETERS <<<<<<<<<<<<<<< =====

ENTER SAVE TO UPDATE CHANGES 13.46.45

Chapter 2 Online Facilities 319

Zoom Screens

Modifying Mission Parameters in the Zoom Screen

Some Zoom screen fields are protected and cannot be modified, depending on the
status of the mission.

To modify mission parameters on the Active Missions file, the mission must be in
HELD status before you enter the Zoom screen to make the desired changes.

Figure 154 Modifying Mission Parameters in the Zoom Screen

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(A.Z)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE REPORTS
===========================================================================
IN PLRPT010-ENDED-OK 0909
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL 000 PRIORITY
DSN MAXWAIT 00
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URG R
MSG ==== REPORT DECOLLATION FOR PLRPT010 ENDED N O T O K ====
SHOUT WHEN TO URG
MSG
===========================================================================
DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES 10
===========================================================================
SET = %% = C CS
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT Y REF NXT N CT AND/OR O
ENTER SAVE TO UPDATE CHANGES. 14.12.30

Exiting the Zoom Screen

Changes made in the Zoom screen can be saved only if the mission has been placed in
HELD status before entering the Zoom screen.

When saving changes, the status of the mission is REQUESTED CHANGE HELD.
Wait until the REQUESTED CHANGE status disappears (indicating that the monitor
has accepted the change), and then free the mission.

The method of exiting the Zoom screen and saving changes can be customized
through the User profile.

By default, END (PF03/PF15) performs a cancel, and the changes are not saved (that
is, no changes are made to the mission entry on the Active Missions file). To save
changes, the SAVE command must be specified.

320 CONTROL-D and CONTROL-V User Guide

 Rerun Option

If customized by the INCONTROL administrator, END (PF03/PF15) displays a

confirmation window if changes have been made, and then performs a save.

Figure 155 Zoom Screen EXIT Option Window

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(A.Z)
COMMAND ===> +---------------------------------------+ SCROLL===> CRSR
+------------------ | |----------------+
CATEGORY DAILY | CONFIRM CHANGES ==> (Y/N) | MONITOR
OWNER M22 T | | JOBID
DESC EMPLOYEE R +---------------------------------------+
================= =============
IN PLRPT010-ENDED-OK 0909
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL 000 PRIORITY
DSN MAXWAIT 00
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URG R
MSG ==== REPORT DECOLLATION FOR PLRPT010 ENDED N O T O K ====
SHOUT WHEN TO URG
MSG
===========================================================================
DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES 10
===========================================================================
SET = %% = C CS
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT Y REF NXT N CT AND/OR O
ENTER CANCEL TO IGNORE CHANGES. 14.21.02

Enter Y (Yes) in the window to save the changes.

Enter N (No) in the window to cancel the changes.

To bypass the confirmation window, exit the Zoom screen as follows:

Enter SAVE in the Zoom screen to save changes.

Enter CANCEL in the Zoom screen to cancel changes.

Rerun Option
The R (Rerun) option is used to rerun the mission. This option is for missions that
have already ended. The mission is returned for possible execution by CONTROL-V
(it is activated when all runtime conditions are met). The RERUN request is recorded
in the IOA Log file.

The mission status is changed to REQUESTED RERUN. If the monitor is active, the
request is accepted after a few seconds.

Entering the Rerun option on a printing mission opens the Rerun window.

Chapter 2 Online Facilities 321

Print Control Print Plan Screen

Rerun Window
Figure 156 Active Missions Environment Rerun Window
------------------- CONTROL-D/V ACTIVE MISSIONS ENVIRONMENT ----------------(A)
COMMAND ===> SCROLL===> CRSR
O NAME ODATE TYP OWNER ------------------STATUS ------------------ UP
INTR0002 080800 REP M331 WAITING FOR JOB
GPLIR17A 080800 REP M335 J06015 ENDED "OK"
GPLIR18 +--------------------------------+
PRDKPL01 | CONFIRM REPRINT (Y/N) |
STD <--------| REBUILD PRINT PLAN (Y/N) |
PRDKPL02 +--------------------------------+
PRDKPL2W 080800 REP M01 J06156 ENDED "OK"
PRDDRPT1 080800 REP M01 J06072 ENDED "OK"
PRDDRPT2 080800 REP M01 J06435 ENDED "OK"
PLRPT010 080800 REP M08A J07028 DECOLLATING
MTRPTU6C 080800 REP MT12 J06871 ENDED- NOT "OK"
EBDMM4D 080800 REP M24 J07019 ENDED "OK"
SPFORM1 080800 PRT M02 HELD WAIT SCHEDULE
BKP0031D 080800 BKP M02 BACKUP IN PROCESS
RST0060M 080800 CRS M02 WAIT SCHEDULE
CBJBRUN 080800 REP M25A WAIT SCHEDULE
SPFORM2 080800 PRT M02 PRINTING ON U1004
BKP0180D 080800 BKP M02 WAIT PROCESS
PRODYHRP 080800 REP M02A J07031 DECOLLATING
PRODYH72 080800 REP M02A WAIT SCHEDULE
OPT: ? WHY H HOLD D DELETE F FREE L LOG Z ZOOM R RERUN P PRINT CONTROL 12.01.11

The Rerun window offers the option of rerunning the printing mission with the
existing Print Plan (that is, reprinting the same bundle), or rebuilding the Print Plan
and then rerunning the mission.

Use the same Print Plan to reprint the same bundle (or part of it). The Print Plan can
be adjusted through user-defined print control symbols. (For more information see
the Print Control Options of the Print Plan Screen in this chapter.)

Rebuild the Print Plan to print reports that have not yet been printed. The rebuilt
Print Plan contains unprinted reports selected from the Active User Reports file.

Print Control Print Plan Screen

Before a printing mission executes, a Print Plan containing all the reports to be
printed by the mission is automatically built. This Print Plan is displayed in the Print
Plan screen. Enter option P in the option field of a printing mission entry in the Active
Missions screen to display the Print Plan screen for the mission.

The screen header line contains the category and name of the printing mission. If the
printing mission is currently printing, the status PRINTING appears in the upper
right corner.

322 CONTROL-D and CONTROL-V User Guide

 Print Control Print Plan Screen

A status line (B) contains the following information about the printing mission:

Table 144 Print Plan Screen Header Fields

Field Description
TOTAL PAGES Total number of pages in the mission
CURRENT PAGE Mission page number currently printing
NUMBER
REPORT PAGE Report page number currently printing
NUMBER

Use the scrolling conventions to scroll the Print Plan screen forward and backward.

To return to the Active Missions screen, press END (PF03/PF15).

Figure 157 Print Plan Screen

----- PRINT PLAN CATEGORY DAILY MISSION STD PRINTING--(A.P)
COMMAND ===> SCROLL===> CRSR
TOTAL PAGES 5524 CURRENT PAGE NUMBER 4705 REPORT PAGE NUMBER 5
O USER REPORT NAME JOBNAME JOBID PAGES LINES PRINTED STAT
BR129LO INVENTORY REPORT PRIVNR2 04500 163 7937 7937 P
MGT EMPLOYEES REPORT PRDEMPS1 08655 152 6737 6737 P
MGT BANK STATEMENTS PRBNKUPT 09261 1402 47649 47649 P
MGT BRANCH REPORTS PRBRCHR4 08210 2983 161081 D W
MGT EXPENSE UPDATES PREXPR1 09261 331 16497 250 A
DEV INVENTORY REPORT PRINVR2 04500 320 16021 W
DEV EMPLOYEES REPORT PRDEMPS1 08655 152 6737 < W
DEV DEVELOPMENT EXPENSES PREXPR2 08657 21 1107 W
========= >>>>>>>>>>>>>>>>>>>> BOTTOM OF PRINT PLAN <<<<<<<<<<<<<<<<< =========

OPTIONS: > SKIP TO REPORT < STOP AT REPORT D DELETE U UNDELETE 15.50.42

Report Fields in the Print Plan Screen

Details of each report in the Print Plan are displayed in the following fields of the
Print Plan screen:

Table 145 Report Fields in the Print Plan Screen (part 1 of 2)

Field Description
USER Name of the report recipient.
REPORT NAME Name of the report.

Chapter 2 Online Facilities 323

Print Control Print Plan Screen

Table 145 Report Fields in the Print Plan Screen (part 2 of 2)

Field Description
JOBNAME Name of the job that generated the report.
JOBID Job ID of the job that generated the report.
PAGES Number of pages in the report.
LINES Number of lines in the report.
PRINTED Number of lines already printed.
STAT A print control symbol and a print status separated by a blank.

Valid print control symbols are:

> Skip to report

< Stop at report
D Delete report
blank None of the above values

These symbols are explained in Print Control Options of the Print

Plan Screen below.

Valid print statuses are:

A Active (currently printing)

W Wait Printing (or Not Printed)
P Printed

Reports are listed in the Print Plan in their scheduled print sequence, from top to
bottom.

When the printing mission is printing, one report shows an Active (A) status
(currently printing). If the print sequence has not been altered, reports above the
currently printing report show a Printed (P) status and reports below it show a Wait
Printing (W) status.

Print Control Options of the Print Plan Screen

The print sequence of reports in the Print Plan can be adjusted by entering valid Print
Control options, as described in the following table:

Table 146 Print Control Options of the Print Plan Screen

Option Description
> Skip to report.
< Stop at report without printing this report.
D Delete this report from the Print Plan.
U Erase a delete, stop, or skip sign from the Print Plan.

324 CONTROL-D and CONTROL-V User Guide

 Print Control Print Plan Screen

Type the desired options in the reports O (Option) field and press Enter. The option
symbol is then displayed in the first column of the STAT field of the report.

All actions performed in the Print Plan screen are recorded in the IOA Log file.

Skip to Report >

The > symbol specifies that Print Control should skip to the indicated report.
Entering this symbol may cause one or both of the following windows to be
displayed:

If a > symbol entered earlier is still in the screen when you enter this symbol again,
the Confirm Override window is opened.

Figure 158 Skip to Report Confirm Override Window

----- PRINT PLAN CATEGORY DAILY MISSION STD PRINTING--(A.P)
COMMAND ===> SCROLL===> CRSR
TOTAL PAGES 5524 CURRENT PAGE NUMBER 4705 REPORT PAGE NUMBER 5
O USER +------------------------------------+ NES PRINTED STAT
BR129LO | One SKIP to report (">") already | 937 7937 P
> MGT <---------| defined. Confirm override (Y/N) | 737 6737 P
MGT +------------------------------------+ 649 47649 > P
MGT BRANCH REPORTS PRBRCHR4 08210 2983 161081 D W
MGT EXPENSE UPDATES PREXPR1 09261 331 16497 250 A
DEV INVENTORY REPORT PRINVR2 04500 320 16021 W
DEV EMPLOYEES REPORT PRDEMPS1 08655 152 6737 W
DEV DEVELOPMENT EXPENSES PREXPR2 08657 21 1107 W
========= >>>>>>>>>>>>>>>>>>>> BOTTOM OF PRINT PLAN <<<<<<<<<<<<<<<<< =========

OPTIONS: > SKIP TO REPORT < STOP AT REPORT D DELETE U UNDELETE 15.50.42

Enter Y (Yes) in the window to override the earlier skip instruction with the new
skip instruction.

Enter N (No) in the window to leave the earlier skip instruction in effect (and
cancel the new one).

If a report is currently printing when the > symbol is entered, the Skip Selection
window is opened:

Chapter 2 Online Facilities 325

Print Control Print Plan Screen

Figure 159 Skip Selection Window

----- PRINT PLAN CATEGORY DAILY MISSION STD ----------(A.P)
COMMAND === +---------------------------------------------+ SCROLL===> CRSR
TOTAL PAGES | Mission has started printing. | E NUMBER 5
O USER | Confirm request (Y/N) | ES PRINTED STAT
BR129LO | SKIP at end of current C-chunk,R-report | 37 7937 P
> MGT +---------------------------------------------+ 37 6737 P
MGT BANK STATEMENTS PRBNKUPT 09261 1402 47649 47649 P
MGT BRANCH REPORTS PRBRCHR4 08210 2983 161081 D W
MGT EXPENSE UPDATES PREXPR1 09261 331 16497 250 A
DEV INVENTORY REPORT PRINVR2 04500 320 16021 W
DEV EMPLOYEES REPORT PRDEMPS1 08655 152 6737 W
DEV DEVELOPMENT EXPENSES PREXPR2 08657 21 1107 W
========= >>>>>>>>>>>>>>>>>>>> BOTTOM OF PRINT PLAN <<<<<<<<<<<<<<<<< =========

OPTIONS: > SKIP TO REPORT < STOP AT REPORT D DELETE U UNDELETE 15.50.42

Enter Y (Yes) in the window to confirm the skip request. Then specify C to skip at
the end of the current chunk or R to skip at the end of the current report.
Enter N (No) in the window to cancel the skip request.

Stop at Report <

The < symbol specifies that printing should stop when the indicated report is
reached.

NOTE
The report indicated with the < symbol is not printed. Only reports prior to the < symbol are
printed. You can print a single report by assigning the symbols > and < to consecutive reports.

If the printing mission is already printing, the < symbol must be placed after the
report that is currently printing.

326 CONTROL-D and CONTROL-V User Guide

 Print Control Print Plan Screen

Figure 160 Stop at Report Confirm Override Window

----- PRINT PLAN CATEGORY DAILY MISSION STD PRINTING--(A.P)
COMMAND ===> SCROLL===> CRSR
TOTAL PAGES 5524 CURRENT PAGE NUMBER 4705 REPORT PAGE NUMBER 5
O USER +------------------------------------+ NES PRINTED STAT
BR129LO | One STOP AT report ("<") already | 937 7937 P
< MGT <---------| defined. Confirm override (Y/N) | 737 6737 P
MGT +------------------------------------+ 649 47649 P
MGT BRANCH REPORTS PRBRCHR4 08210 2983 161081 D W
MGT EXPENSE UPDATES PREXPR1 09261 331 16497 250 A
DEV INVENTORY REPORT PRINVR2 04500 320 16021 W
DEV EMPLOYEES REPORT PRDEMPS1 08655 152 6737 < W
DEV DEVELOPMENT EXPENSES PREXPR2 08657 21 1107 W
========= >>>>>>>>>>>>>>>>>>>> BOTTOM OF PRINT PLAN <<<<<<<<<<<<<<<<< =========

OPTIONS: > SKIP TO REPORT < STOP AT REPORT D DELETE U UNDELETE 15.50.42

If no < symbol is used, printing continues until the end of the printing mission.

If a < symbol entered earlier is still on the screen when you enter another < symbol,
the Confirm Override window is opened:

Enter Y (Yes) in the window to override the earlier stop instruction with the new
stop instruction.

Enter N (No) in the window to leave the earlier stop instruction in effect (and
cancel the new one).

Delete D

D (Delete) identifies reports that are not to be printed. Although the report listing is
not removed from the Print Plan file, D indicates that the report is to be bypassed
during printing.

NOTE
Delete symbols remain after the reports have been bypassed. If the printing mission is rerun
with the same Print Plan, the deleted reports are bypassed again.

Undelete U

Deleted reports can be undeleted by entering option U (Undelete); the delete is

immediately removed. Whether or not an undeleted report actually prints depends
on its location relative to the currently printing report.

U also cancels a stop or skip sign on the same line.

Chapter 2 Online Facilities 327

CONTROL-D Objects Facility

CONTROL-D Objects Facility

The CONTROL-D Objects facility enables you to create and maintain the following
CONTROL-D objects:

Report Cliques on page 329

Resource Sets on page 354
Resources on page 358
Clique Resources on page 360

Accessing the CONTROL-D Objects Facility

To enter the CONTROL-D Objects facility, select option DO on the IOA Primary
Option menu and press Enter. The CONTROL-D Objects entry panel is displayed.

Figure 161 CONTROL-D Objects Entry Panel

------------------------ CONTROL-D OBJECTS ENTRY PANEL --------------------(DO)
COMMAND ===>

SPECIFY TYPE OF THE OBJECT: 1 - Report Cliques

2 - Resource Sets
3 - Resources
4 - Clique Resources

USE THE COMMAND SHPF TO SEE PFK ASSIGNMENT 16.47.47

To select one of these options, type the option number in the SPECIFY TYPE OF THE
OBJECT field, then press Enter.

328 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Report Cliques
This option allows you to define or modify Report Cliques that are used in report
transformation. Transformation is the process of extracting data from print stream
reports (such as AFP or Xerox) and converting them into a viewable format (such as
PDF or HTML). A Report Clique includes all the information necessary to transform a
print stream report. To use transformation in decollation, you define a decollation
mission definition with the CLIQUE subparameter set to a Report Clique name.

For more information on defining decollation missions that use Report Cliques, see
ON Statement: Decollating Parameter on page 560. For more information on
preparing print stream reports for transformation, see Decollation of Report Types
on page 807. For more information about rendering to PDF see the CONTROL-D
and CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

Entry Panel
After you select option 1 from the CONTROL-D Objects Entry Panel, the
CONTROL-D Reports Cliques Entry Panel is displayed.

Figure 162 CONTROL-D Reports Cliques Entry Panel

-------------------- CONTROL-D REPORTS CLIQUES ENTRY PANEL ---------------(DO.1)
COMMAND ===>

CLIQUE NAME ===> Report clique name or mask

CLIQUE FORMAT ===> 1.TXT 2.AFP 3.XRX 4.PDF
OWNER ===> Report clique owner
DATE FROM ===> TO Report clique last update date

FILL IN THE SELECTION CRITERIA AND PRESS ENTER 16.13.36

To display all of the Report Cliques: Leave all of the selection criteria fields blank,
then press Enter. The CONTROL-D Reports Cliques screen is displayed listing all
of the Report Cliques.

Chapter 2 Online Facilities 329

Report Cliques

To display a selected set of the Report Cliques: Type a value in at least one of the
selection criteria fields as described in Table 147, then press Enter. The
CONTROL-D Reports Cliques screen is displayed listing the set of Report Cliques
that you selected.

Table 147 Report Clique Selection Criteria Fields

Field Description
CLIQUE NAME The name or mask for the Report Cliques to be displayed. From 1
through 12 characters. Valid characters are a-z, A-Z, 0-9, - (hyphen),
and _ (underscore).
CLIQUE FORMAT The format of the Report Cliques to be displayed. Valid values are:

1 (TXT)Text Reports
2 (AFP)Advanced Function Printing
3 (XRX)Xerox report, LCDS, or Metacode
4 (PDF)Adobe Acrobat Portable Document Format
OWNER The user ID of the owner of the Report Cliques to be displayed.
DATE FROM and The date range within which Report Cliques were created.

DATE TO

Reports Cliques List Screen

After selecting the selection criteria from the CONTROL-D Reports Cliques Entry
Panel, the CONTROL-D Reports Cliques List screen is displayed with the set of
Report Cliques you selected.

Figure 163 CONTROL-D Reports Cliques List

----------------------- CONTROL-D REPORT CLIQUES LIST -----------------(DO.C)
COMMAND ===> SCROLL===> CRSR
OPT --- NAME --- CHANGED OWNER FORMAT
LQCLIQUEAXA1 11/02/02 17:37 N52W AFP
LQCLIQUEHEW1 11/02/02 17:35 N52A XRX
LCDSSAMP 13/03/02 20:04 N52W XRX
LEONID 27/05/03 11:05 M33W AFP
LEONIDT 16/03/04 18:46 M33 TXT
LEONID123456 07/03/02 14:58 M33W AFP
LIMPDF 28/08/03 12:28 N16B PDF
LQRINA3 11/02/02 18:14 N30A AFP
======= >>>>>>>>>>>>>>>>> E N D O F L I S T <<<<<<<<<<<<<<<<< =======

OPTIONS: S SELECT D DELETE COMMANDS: NEW 17.16.56

330 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Options of the CONTROL-D Reports Cliques List

For existing Report Clique definitions, you have the option to either select or delete a
definition.

To request one of the following options, type the option in the OPT field to the left of
the Report Clique name, and press Enter.

Table 148 Options of the CONTROL-D Reports Cliques List

Option Description
S (SELECT) Display the CONTROL-D Report Clique definition screen for the
selected Report Clique. Only one Report Clique can be selected at a
time. For a description of the parameters on the CONTROL-D Report
Clique definition screen, see CONTROL-D Report Clique Definition
Screen on page 332.
D (DELETE) Delete a Report Clique.

Create a New Report Clique Definition

To create a new Report Clique definition, do the following:

1 In the command field of the CONTROL-D Reports Clique List screen, type the
following command:

NEW format

where format is a valid report clique format (either AFP,TXT, XRX, or PDF)

2 Press Enter. The CONTROL-D Report Clique definition screen is displayed for the
report clique format that you selected.

NOTE
If you enter only the NEW command, or the NEW command with an invalid report clique
format, the SELECT FORMAT window is displayed. To select a report clique format from this
window, type S in the column to the left of the report clique format, and press Enter.

Chapter 2 Online Facilities 331

Report Cliques

Figure 164 Reports Cliques Select Format Window

----------------------- CONTROL-D REPORT CLIQUES LIST -----------------(DO.C)
COMMAND ===> SCROLL===> CRSR
OPT --- NAME --- CHANGED OWNER FORMAT
LQCLIQ++2/02 17:37 N52W AFP
LQCLIQ| SELECT FORMAT: |2/02 17:35 N52A XRX
LCDSSA| |3/02 20:04 N52W XRX
LEONID| =============== |5/03 11:05 M33W AFP
LEONID| TXT |3/04 18:46 M33 TXT
LEONID| AFP |3/02 14:58 M33W AFP
LIMPDF| XRX |8/03 12:28 N16B PDF
LQRINA| PDF |2/02 18:14 N30A AFP
======= >>>| S SELECT | D O F L I S T <<<<<<<<<<<<<<<<< =======
++

OPTIONS: S SELECT D DELETE COMMANDS: NEW 17.16.56

CONTROL-D Report Clique Definition Screen

After either selecting an existing Report Clique definition or after creating a new
Report Clique definition, the CONTROL-D Report Clique definition screen is
displayed.

The screen that is displayed depends on the type of report that is defined for the
Report Clique. The following are sample screens for TEXT, AFP, Xerox, and PDF
reports.

Figure 165 CONTROL-D Report Clique Screen for Text Reports

--------------- CONTROL-D REPORT CLIQUE FORMAT TXT ---------(DO.Z)
COMMAND ===> SCROLL===> CRSR
----- Property ----------------- ----- Value ---------- (Edit) ------------C
==== >> T O P O F R E P O R T C L I Q U E P R O P E R T I E S << ====
1. General Parameters
Owner of Report Clique = N30A
Page Width In Inches = 0
Page Height In Inches = 0
OS390 Resource Library List Name = *
Fail on missing resources = Decollate
Never/Always/Decollate
Default Resource Directory = N
Report Encoding = Latin1
Report Language = English
Print Control Char = None
ASA/Machine/None
TRC character used = N (Y/N)
3. Row Col Parameters
Number of Rows = 150
Number of Columns = 150

332 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Text Orientation 0 = Y (Y/N)

Text Orientation 90 = Y (Y/N)
Text Orientation 180 = Y (Y/N)
Text Orientation 270 = Y (Y/N)
Fonts To Ignore = N
Include External Overlays = Y (Y/N)
Include Internal Overlays = Y (Y/N)
4. Rendering Parameters
Rotation = 0
0/90/180/270
Shadowing = OnlyHigh
Yes/No/OnlyHigh
Shadowing Style = Gray
Gray/Pattern
Half Tone = Y (Y/N)
Max Render Pages = 2000
Font Mapping Table Name = FONTMAP
Split Words = N (Y/N)
Color = Y (Y/N)
Font File Name = Default N
Font Name = N
Font Size = 10
5. PDF Rendering Parameters
Add Background Image = None N
Print = Y (Y/N)
Copy = Y (Y/N)
Modify = Y (Y/N)
Font Subsetting = Y (Y/N)
Master Password = NONE
Pdf Resolution = 300
Pdf Raster = None
None/All/Graphics/Text
Encoding = NONE
Code Page = 0
6. Html Rendering Parameters
XResolution = 96
YResolution = 96
Background Image Url = N
Use EOT Fonts = Y (Y/N)
Use PFR Fonts = Y (Y/N)
X Offset = 0
Y Offset = 0
Background Color = None
None/White/Black/Blue/Gray/Red/Yellow/
Brown/Aque/LawnGreen/Beige/Green
Foreground Color = None
None/White/Black/Blue/Gray/Red/Yellow/
Brown/Aque/LawnGreen/Beige/Green
Image XResolution = 0
Image YResolution = 0
7. Pcl Rendering Parameters
PCL Paper Source = A4
A4/Letter/Executive/Legal/Ledger/A3/
Monarch/Com-10/International_Dl/
International_C5/International_B5
PCL Resolution = 300
300/600
PCL Scale = 0
PCL Y Offset = 0
PCL X Offset = 0
==== >> E N D O F R E P O R T C L I Q U E P R O P E R T I E S << ====
17.22.55

Chapter 2 Online Facilities 333

Report Cliques

Figure 166 CONTROL-D Report Clique Screen for AFP Reports

--------------- CONTROL-D REPORT CLIQUE FORMAT AFP ---------(DO.Z)
COMMAND ===> SCROLL===> CRSR
----- Property ------- -------- Value ----------------- --C
1. General Parameters
Owner of Report Clique = M52
Page Width In Inches = 0
Page Height In Inches = 0
OS390 Resource Library List Name = *
Fail on missing resources = Decollate
Never/Always/Decollate
Default Resource Directory = N
2. AFP Parameters
AFP Formdef Name =
AFP Input Type = AfpCategory5
AfpCategory4/AfpCategory5
AFP Pagedef Name =
Record Delimiter = rdw
rdw/fixed
Length of input records = 133
Print Control Character = ASA
ASA/MACHINE
Code of input AFP = EBCDIC
EBCDIC/ASCII
TRC character used = N (Y/N)
3. Row Col Parameters
Number of Rows = 150
Number of Columns = 150
Text Orientation 0 = Y (Y/N)
Text Orientation 90 = Y (Y/N)
Text 1Orientation 180 = Y (Y/N)
Text Orientation 270 = Y (Y/N)
Fonts To Ignore = N
Include External Overlays = Y (Y/N)
Include Internal Overlays = Y (Y/N)
4. Rendering Parameters
Rotation = 0
0/90/180/270
Shadowing = OnlyHigh
Yes/No/OnlyHigh
Shadowing Style = Gray
Gray/Pattern
Half Tone = Y (Y/N)
Max Render Pages = 2000
Font Mapping Table Name = FONTMAP
Split Words = N (Y/N)
Color = N (Y/N)

334 CONTROL-D and CONTROL-V User Guide

 Report Cliques

5. PDF Rendering Parameters

Add Background Image = None N
Print = Y (Y/N)
Copy = Y (Y/N)
Modify = Y (Y/N)
Font Subsetting = Y (Y/N)
Master Password = NONE
PDF Resolution = 300
PDF Raster = None
None/All/Graphics/Text
Encoding = NONE
Code Page = 0
6. HTML Rendering Parameters
XResolution = 96
YResolution = 96
Background Image Url = N
Use EOT Fonts = Y (Y/N)
Use PFR Fonts = Y (Y/N)
X Offset = 0
Y Offset = 0
Background Color = White
White/Black/Blue/Gray/Red/Yellow/Brown/
Aque/LawnGreen/Beige/Green
Foreground Color = Black
White/Black/Blue/Gray/Red/Yellow/Brown/
Aque/LawnGreen/Beige/Green
Image XResolution = 0
Image YResolution = 0
7. PCL Rendering Parameters
PCL Paper Source = A4
A4/Letter/Executive/Legal/Ledger/A3/
Monarch/Com-10/International_Dl/
International_C5/International_B5
PCL Resolution = 300
300/600
PCL Scale = 0
PCL Y Offset = 0
PCL X Offset = 0
==== >> E N D O F R E P O R T C L I Q U E P R O P E R T I E S << ====
17.22.55

Chapter 2 Online Facilities 335

Report Cliques

Figure 167 CONTROL-D Report Clique Screen for Xerox Reports

--------------- CONTROL-D REPORT CLIQUE FORMAT XRX ---------(DO.Z)
COMMAND ===> SCROLL===> CRSR
----- Property ------- -------- Value ----------------- --C
1. General Parameters
Owner of Report Clique = M52
Page Width In Inches = 0
Page Height In Inches = 0
OS390 Resource Library List Name = *
Fail on missing resources = Decollate
Never/Always/Decollate
Default Resource Directory = N
2. Xerox Parameters
Record Delimiter = rdw
rdw/fixed
JSL Name =
JDE Name =
SysCatalog Name = syscatlg
DEBUG = N (Y/N)
Debug File Name = N
Error File Name = N
From X Offset = 0
From Y Offset = 0
Page Data X Offset = 0
Page Data Y Offset = 0
Line Advance method for = Max
Max/Last
Report identifier = N
Scan Origin Point = 22
Dot Origin Point = 100
3. Row Col Parameters
Number of Rows = 150
Number of Columns = 150
Text 0 Degrees = Y (Y/N)
Text 90 Degrees = Y (Y/N)
Text 180 Degrees = Y (Y/N)
Text 270 Degrees = Y (Y/N)
Fonts To Ignore = N
Include External Overlays = Y (Y/N)
Include Internal Overlays = Y (Y/N)
4. Rendering Parameters
Rotation = 0
0/90/180/270
Shadowing = OnlyHigh
Yes/No/OnlyHigh
Shadowing Style = Gray
Gray/Pattern
Half Tone = Y (Y/N)
Max Render Pages = 2000
Font Mapping Table Name = FONTMAP N
Split Words = N (Y/N)
Color = N (Y/N)
5. PDF Rendering Parameters
Add Background Image = None N
Print = Y (Y/N)
Copy = Y (Y/N)
Modify = Y (Y/N)
Font Subsetting = Y (Y/N)
Master Password = NONE
PDF Resolution = 300
PDF Raster = None
None/All/Graphics/Text

336 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Encoding = NONE
Code Page = 0
6. HTML Rendering Parameters
XResolution = 96
YResolution = 96
Background Image Url = N
Use EOT Fonts = Y (Y/N)
Use PFR Fonts = Y (Y/N)
X Offset = 0
Y Offset = 0
Background Color = None
None/White/Black/Blue/Gray/Red/Yellow/
Brown/Aque/LawnGreen/Beige/Green
Foreground Color = None
None/White/Black/Blue/Gray/Red/Yellow/
Brown/Aque/LawnGreen/Beige/Green
Image XResolution = 0
Image YResolution = 0
7. PCL Rendering Parameters
PCL Paper Source = A4
A4/Letter/Executive/Legal/Ledger/A3/
Monarch/Com-10/International_Dl/
International_C5/International_B5
PCL Resolution = 300
300/600
PCL Scale = 0
PCL Y Offset = 0
PCL X Offset = 0
==== >> E N D O F R E P O R T C L I Q U E P R O P E R T I E S << ====
11.44.58

Figure 168 CONTROL-D Report Clique Screen for PDF Reports

--------------- CONTROL-D REPORT CLIQUE FORMAT XRX ---------(DO.Z)
COMMAND ===> SCROLL===> CRSR
----- Property ----------------- ----- Value ---------- (Edit) ------------C
1. General Parameters
Owner of Report Clique = N30A
Page Width In Inches = 0
Page Height In Inches = 0
OS390 Resource Library List Name = *
Fail on missing resources = Decollate
Never/Always/Decollate
Default Resource Directory = N
3. Row Col Parameters
Number of Rows = 150
Number of Columns = 150
Text Orientation 0 = Y (Y/N)
Text Orientation 90 = Y (Y/N)
Text Orientation 180 = Y (Y/N)
Text Orientation 270 = Y (Y/N)
Fonts To Ignore = N
Include External Overlays = Y (Y/N)
Include Internal Overlays = Y (Y/N)
4. Rendering Parameters
Rotation = 0
0/90/180/270
Shadowing = OnlyHigh
Yes/No/OnlyHigh
Shadowing Style = Gray
Gray/Pattern
Half Tone = Y (Y/N)

Chapter 2 Online Facilities 337

Report Cliques

Max Render Pages = 2000

Font Mapping Table Name = FONTMAP N
Split Words = N (Y/N)
Color = Y (Y/N)
5. PDF Rendering Parameters
Add Background Image = None N
Print = Y (Y/N)
Copy = Y (Y/N)
Modify = Y (Y/N)
Font Subsetting = Y (Y/N)
Master Password = NONE
Pdf Resolution = 300
Pdf Raster = None
None/All/Graphics/Text
Encoding = NONE
Code Page = 0
6. Html Rendering Parameters
XResolution = 96
YResolution = 96
Background Image Url = N
Use EOT Fonts = Y (Y/N)
Use PFR Fonts = Y (Y/N)
X Offset = 0
Y Offset = 0
Background Color = None
None/White/Black/Blue/Gray/Red/Yellow/
Brown/Aque/LawnGreen/Beige/Green
Foreground Color = None
None/White/Black/Blue/Gray/Red/Yellow/
Brown/Aque/LawnGreen/Beige/Green
Image XResolution = 0
Image YResolution = 0
7. Pcl Rendering Parameters
PCL Paper Source = A4
A4/Letter/Executive/Legal/Ledger/A3/
Monarch/Com-10/International_Dl/
International_C5/International_B5
PCL Resolution = 300
300/600
PCL Scale = 0
PCL Y Offset = 0
PCL X Offset = 0
==== >> E N D O F R E P O R T C L I Q U E P R O P E R T I E S << ====

Continuation Lines

If a Report Clique parameter has a value (either Y or N) set in the C (Continue) field
on the right side of the screen, this indicates that you can add continuation lines to
that parameter value, if needed. By default, the C field is set to N (No).

To add a continuation line: Type Y in the C field of the line you want to continue,
and press Enter. A blank, new line is displayed below the continued line, allowing
you to enter up to 42 extra characters.

To close a continuation line: Type N in the C field directly above the line to be
closed, and press Enter. The line below the continued line is closed.

338 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Report Clique Parameters

Parameters common to all types of Report Cliques are described in Table 149.

Table 149 Common Report Clique Parameters (part 1 of 8)

Name of Parameter
Name of Parameter in Specified in the
the DO Screen TRANSTO Member Description
General Parameters
Report Format reportformat Type (format) of the report. Valid values include AFP, XRX,
PCL, TXT, PDF, PS.

Note: Each report type, except PDF, has its own unique
parameter section described later in this chapter.
Report Clique Name reportcliquename Unique name assigned to the Report Clique.

Default: Untitled.
Owner of Report Clique owner User ID of the Report Clique owner.
Report Clique Change changedate Date that the Report Clique was last changed.
Date
Report Clique Change changetime Time that the Report Clique was last changed.
Time
Page Width in Inches pagewidthininches Page width, measured in inches. If the page width is smaller
than the report width, the report is truncated. If the page
width is larger than the report width, the page has extra
space.

Default: 0. This indicates that the width of the report page

taken from the report definition.

Notes:

In Text reports, the width does not affect the text

view.
This parameter does not influence Xerox reports.
Page Height in Inches pageheightininches Page height, measured in inches. If the page height is
smaller than the report height, the report is truncated. If the
page height is larger than the report height, the page has
extra space.

Default: 0. This indicates that the height of the report page

taken from the report definition.

Notes:

In Text reports, the height does not affect the text

view.
This parameter does not influence Xerox reports.

Chapter 2 Online Facilities 339

Report Cliques

Table 149 Common Report Clique Parameters (part 2 of 8)

Name of Parameter
Name of Parameter in Specified in the
the DO Screen TRANSTO Member Description
Notes:

It is recommended that you use the default page width and height for all formats.

If the report is rotated 90 or 270, the Page Height in Inches value is used for the width, and the Page
Width in Inches value is used for the height.
OS390 Resource Library os390resourceliblist Name of a set of System Resource Libraries from which all
List Name name default resources are taken. Up to 8 characters. Blanks are
not allowed.

Default: *.

The Resource Library list names are defined in the

$$TRNRES member in the CTDPARM library.
Fail on missing failonmissingresour Indicates whether to abort the transformation if non-critical
resources ces resources are missing. Valid values are:

Nevernever abort when resources are missing

Alwaysalways abort when resources are missing
Decollateonly abort when decollating the report, but
not when viewing it. Default.
Row Col Parameters
Include Comments in rowcolincludecomm Yes or No. Indicates whether to add the report comments at
Rowcol Page ents the end of the rowcol page, in orientation 0. Optional.
Default: No

Note: For AFP, this parameter applies to the data from the
TLE and NOP records of AFP pages.
Number of Rows rowcolnrows Number of grid rows into which the report page is divided.
Default: 150.
Number of Columns rowcolncolumns Number of grid columns into which the report page is
divided. Default: 150.
Text Orientation 0 rowcoltext_0_degree Yes or No. Indicates whether the transformer checks for text
s at 0 degrees. Default: Yes.
Text Orientation 90 rowcoltext_90_degre Yes or No. Indicates whether the transformer checks for text
es at 90 degrees. Default: Yes.
Text Orientation 180 rowcoltext_180_deg Yes or No. Indicates whether the transformer checks for text
rees at 180 degrees. Default: Yes.
Text Orientation 270 rowcoltext_270_deg Yes or No. Indicates whether the transformer checks for text
rees at 270 degrees. Default: Yes.

340 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Table 149 Common Report Clique Parameters (part 3 of 8)

Name of Parameter
Name of Parameter in Specified in the
the DO Screen TRANSTO Member Description
Fonts to Ignore rowcolfontstoignore A list of fonts, separated by commas, that are ignored.
Optional. Default: None (all fonts included).

Note: For AFP fonts, the font name must begin with C0. For
example, specify C0H1001B even if the font name is
C1H1001B.
Include External rowcolincludeextern Yes or No. Indicates whether text in external overlays is
Overlays aloverlays included in transformation. Optional. Default: Yes.
Include Internal rowcolincludeintern Yes or No. Indicates whether text in internal overlays is
Overlays aloverlays included in transformation. Optional. Default: Yes.
Rendering Parameters
Rotation rotation Degree of clockwise rotation of the report. Valid values are:
0, 90, 180, 270.

Default: 0.
Shadowing shadowing Indicates whether shadowing should appear: Valid values
are:

Yesallow shadowing to appear

Noremove shadowing
Only HighShadowing appears only in high resolution
output (printing). Default.
Shadowing Style shadowingstyle Specifies the type of shadowing. Valid values are:

GrayShadowing is displayed as solid gray.

Recommended for viewing. Default.
PatternShadowing is displayed as a pattern of lines.
Recommended for printing.
Half Tone halftone Yes or No. Indicates whether the Halftone algorithm (which
allows grays) is used for drawing bitmap images: Valid
values are:

Yesuse the Halftone algorithm. Default.

Nouse the Black on White algorithm (everything
appears in black or white, no grays)
Max Render Pages maxrenderpages Maximum number of pages to transform.

Default: 2000.
Font Mapping Table fontmappingtablena Name of the table that is used for font mapping. Optional.
Name me Default: fontmap

Chapter 2 Online Facilities 341

Report Cliques

Table 149 Common Report Clique Parameters (part 4 of 8)

Name of Parameter
Name of Parameter in Specified in the
the DO Screen TRANSTO Member Description
Split Words splitwords Indicates whether to split words and recalculate their
location. Optional. Valid values are:

Yes Split words according to blanks. This value is

useful when the original font is wider than rendering
font, and the report contains tables. It results in a larger
PDF.

No If there is one blank between words, leave as a

sentence. Default.
Color color Specifies whether the resulting output is in color. Optional.
Valid values are:

Yes The colors in the original report are displayed in

the PDF or HTML output. Default.
No The output is in black and white only.
PDF Rendering Parameters
Add Background Image addbackgroundima File name of an image (for example copy.gif) that is added
ge over each page of the PDF file. The image must reside in the
default resource directory (installation/transformer/res).
Supported image types are those supported by PDFlib: gif,
tif, jpg, png, bmp. The image is always displayed from the
left bottom corner of the page.

Optional. Default: no image.

Print pdfprint Indicates whether printing the PDF file is allowed (that is,
permission is granted). Optional. Valid values are:

Yes Printing the PDF file is allowed. Default.

No Printing the PDF file is not allowed.
Copy pdfcopy Indicates whether copying the PDF file is allowed (that is,
permission is granted). Optional. Valid values are:

Yes Copying the PDF file is allowed. Default.

No Copying the PDF file is not allowed.

342 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Table 149 Common Report Clique Parameters (part 5 of 8)

Name of Parameter
Name of Parameter in Specified in the
the DO Screen TRANSTO Member Description
Modify pdfmodify Indicates whether modifying the PDF file in Acrobat is
allowed (that is, permission is granted). Optional. Valid
values are:

Yes Modifying the PDF file is allowed. Default.

No Modifying the PDF file is not allowed.

Note: If a PRINT mission generates a PDF report with

STORE=Y and Modify = N, the PDF is protected against
extracting anything. With these settings, Application Server
cannot extract data (from an indexed report) to create a
partial report according to the required index.
Font Subsetting pdffontsubsetting Limits font embedding to only those characters that are
actually used in the PDF document (instead of all characters
in the font). Optional. Valid values are:

Yes Embed only those characters used. Default.

No Embed all characters in the font.
Master Password pdfmasterpassword Indicates whether a master password is required to change
any security settings (such as permissions, user password,
or master password). Default: No.
PDF Resolution pdfresolution Resolution of the PDF image file. Higher resolutions
produce better quality images, while lower resolutions
produce smaller files and faster transformations.

Valid values are: from 72 through 300. Default: 300.

Pdf Raster pdfraster Specifies which elements are rastered on a bitmap and
inserted into the PDF as a background image. Valid values
are:

None - all elements are drawn in the PDF as PDF

elements:
Rastered text that is not mapped by the fontmap.tbl
is inserted into the PDF file as TYPE3 fonts. Default.
Graphics elements are drawn as PDF graphic
elements.
All - all elements, except mapped fonts, are rastered on a
bitmap and inserted into the PDF as a background
image.
Graphics - all graphics elements (such as lines and filled
areas) are rastered on a bitmap and added to the PDF as
a background image. Other elements are drawn in the
PDF as PDF elements.
Text - all rastered text are rastered on a bitmap and
added to the PDF as a background image. Other
elements are drawn on the PDF as PDF elements.

Chapter 2 Online Facilities 343

Report Cliques

Table 149 Common Report Clique Parameters (part 6 of 8)

Name of Parameter
Name of Parameter in Specified in the
the DO Screen TRANSTO Member Description
PDF Encoding encoding Text encoding. Supported language encoding. Optional.
Valid values are:

None (Latin-1 encoding). Default.

Unicode-all other encoding (the text in the PDF is in
Unicode)
Code Page code_page_num Code page used. Optional. Default selected according to the
PDF Encoding parameter.
HTML Rendering Parameters
XResolution xresolution X-resolution of the output PNG or HTML. This does not
affect PDF output. Higher values create a longer image.

Valid values are: From 10 through 300. Default: 96.

YResolution yresolution Y-resolution of the output PNG or HTML. This does not
affect PDF output. Higher values create a wider image.

Valid values are: From 10 through 300. Default: 96.

Background Image Url htmlbackgroundima URL of an image that is displayed as a background for the
geurl HTML page. The image is always displayed from the top
left corner of the page. Optional. No default.
Use EOT Fonts htmluseeotfonts Yes/No indicator whether EOT fonts are used if EOT Web-
enabled fonts are mapped in the font-mapping table.
Default: Yes
Use PFR Fonts htmlusepfrfonts Yes/No indicator whether PFR fonts are used if PFR Web-
enabled fonts are mapped in the font-mapping table.
Default: Yes
X Offset htmlxoffset Causes text and images to move horizontally. Negative
numbers shift the data left, and positive numbers shift the
data right. Values are specified in pixels, based on the
original document resolution. Default: 0
Y Offset htmlyoffset Causes the text and images to move vertically. Negative
numbers shift the data up, and positive numbers shift the
data down. Values are specified in pixels, based on the
original document resolution. Default: 0
Background Color htmlbackgroundcol Color of the HTML background. Optional. Default: none
or (the default color set by the browser is used).
Foreground Color htmlforegroundcolo Color of the HTML foreground. Optional. Default: none (the
r default color set by the browser is used).

344 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Table 149 Common Report Clique Parameters (part 7 of 8)

Name of Parameter
Name of Parameter in Specified in the
the DO Screen TRANSTO Member Description
Image XResolution imagexres Specifies the X resolution of the output BACKGROUND
image. The actual HTML size is determined by the X/Y
resolution parameter. The quality of printed HTML graphics
is better with higher resolution. When Image XResolution is
not set, but Image YResolution is set, the same value is used
for Image XResolution. Valid values are:

Minimum: 0 (indicates that this parameter is ignored).

Default.

Maximum: 300.
Image YResolution imageyres Specifies the Y resolution of the output BACKGROUND
image. The actual HTML size is determined by the X/Y
resolution parameter. The quality of printed HTML graphics
is better with higher resolution. When Image YResolution is
not set, but Image XResolution is set, the same value is used
for Image YResolution. Valid values are:

Minimum: 0 (indicates that this parameter is ignored).

Default.

Maximum: 300.
PCL Rendering Parameters
PCL Paper Source pclpapersource Name of the PCL paper source (paper size). Optional.
Default: A4
PCL Resolution pclprinterresolution PCL printout resolution in bpi (bytes per inch). Valid values
are:

300. Default.
600
PCL Margins pclmargine Obsolete.

Indicates whether the page is created with margins.

Optional. Valid values are:

Yespage created with margins; the page is smaller so all

the data fits within the margins. Default.

Nopage printed as is; data positioned in the margin area is

lost.

Note: The PCL Margins parameter (from releases 3.2.00 and

3.5.00) was replaced with the following three parameters.

Chapter 2 Online Facilities 345

Report Cliques

Table 149 Common Report Clique Parameters (part 8 of 8)

Name of Parameter
Name of Parameter in Specified in the
the DO Screen TRANSTO Member Description
PCL Scale pclscale Percent by which to decrease the size of the output page.
This is useful if the PCL margins cause printed data to be
lost. Optional.

Minimum: 0. Maximum: 80.

Default: 0 (no scaling)

PCL Y Offset pclyoffset Shifts the text and images on the rendered page vertically,
according to the number of pixels specified. Negative
numbers shift the data up, and positive numbers shift the
data down.

Optional. Minimum: -12,000. Maximum: 12,000. Default: 0

(no shift).
PCL X Offset pclxoffset Shifts the text and images on the rendered page
horizontally, according to the number of pixels specified.
Negative numbers shift the data left, and positive numbers
shift the data right.

Optional. Minimum: -12,000. Maximum: 12,000. Default: 0

(no shift).

Parameters Unique to AFP Report Cliques

The following Report Clique parameters are unique to AFP reports.

Table 150 Parameters Unique to Advanced Function Presentation (AFP) Report Cliques (part 1 of 2)
(part 1 of 2)
Name of Parameter
Name of Parameter Specified in the
in the DO Screen TRANSTO Member Description
Afp Formdef Name afpformdefname Name of the FORMDEF used in the report.

Default: The first FORMDEF in the resource section of the report.

AFP Input Type; afpinputtype The type of AFP input. Valid values are:

AfpCategory4 - AFP Category 4

AfpCategory5 - AFP Category 5. Default.

Anything less than AfpCategory5 is treated as AfpCategory4.

Afp Pagedef Name afppagedefname The name of the Pagedef used in the report. Optional. Used for
AFP Category 4 input only.

Default: first Pagedef in the resource section of the report.

346 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Table 150 Parameters Unique to Advanced Function Presentation (AFP) Report Cliques (part 2 of 2)
(part 2 of 2)
Name of Parameter
Name of Parameter Specified in the
in the DO Screen TRANSTO Member Description
Record Delimiter afprecdelim The input report record type. Mandatory. Valid values are:

rdw - variable length data, each record starting with XXYY ,

where XX designates the record length and YY is binary zeros.
fixed - all records have the same length. Used for AFP
Category 4 input only.
Length of input recordlength The record length of input fixed-type AFP records. Used for AFP
records Category 4 input only. (For rdw-type records, this parameter is
ignored.)

Maximum number is 32760. Default: 133.

Print control afpprintcontrolchar The type of Print control characters used. Used for AFP Category
character 4 input only. Valid values are:

ASA. Default.
MACHINE
Code of input AFP afpinputcode The code of the AFP input. Used for AFP Category 4 input only.
This parameter refers to the original encoding of the report.
Reports translated from EBCDIC to ASCII do work (because the
Code Pages used are for EBCDIC reports). Valid values are:

ASCII
EBCDIC. Default.
TRC character used afpinputtrc The parameter determines if TRC character exists in report. Used
for AFP Category 4 input only. Valid values:

Yes
No

Default: No

Chapter 2 Online Facilities 347

Report Cliques

Parameters Unique to Text Report Cliques

Report Clique parameters that are unique to Text reports are located in the General
Parameters section, described in Table 151, the Decollation Parameters section,
described in Table 152, and the Rendering Parameters section, described in Table 153.

Table 151 General ParametersUnique to Text Report Cliques

Name of Name of Parameter
Parameter in the Specified in the
DO Screen TRANSTO Member Description
Report Encoding reportencoding This parameter specifies the report encoding. The report is
translated from the specified coding to Latin1 in LEGACY mode
or to UTF-8 in UNICODE mode, and then kept in the translated
encoding.

Default: Latin1 in LEGACY; or UTF-8 in UNICODE

Report Language reportlanguage This parameter is used only when working in UNICODE mode.

It specifies the report language, and is used to select the correct

font.

Default: English
Report normalizedencoding The parameter specifies the internal report encoding in
Normalized CONTROL-D. The report is translated from the encoding
Encoding specified in Report Encoding parameter to Normalized
encoding, and is kept in the Normalized encoding. This
parameter is valid only for Legacy mode, in UNICODE mode
Normalized Encoding is always UTF-8.

Optional. Default: Latin1 in Legacy mode or UTF-8 in UNICODE

mode.
Print Control printcontrolchar The Text report contains Print Control characters which should
Char be used when viewing the report. Valid values are:

ASA
Machine
None. Default.
TRC character inputtrc The parameter determines if TRC character exists in report.
used Valid values are:

Yes
No. Default.

348 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Table 152 Decollation ParametersUnique to Text Report Cliques (part 1 of 2)

Name of Parameter
Name of Parameter Specified in the
in the DO Screen TRANSTO Member Description
Note: The following three parameters are mutually exclusive - only one should be specified. If more than one
is specified, the results are unpredictable.
Page Delimiter String pagedelimiterstring String used to indicate End of Page.
Page Delimiter Hex pagedelimiterhex Hex value used to indicate End of Page.
Page Delimiter Dec pagedelimiterdec Decimal value used to indicate End of Page.
Note: The following four parameters are mutually exclusive - only one should be specified. If more than one
is specified, the results are unpredictable.
Line Delimiter String linedelimiterstring String used to indicate the end of a line.
Line Delimiter Hex linedelimiterhex Hex value used to indicate the end of a line.

Default: X0D0A (crlf-carriage return line feed).

Line Delimiter Dec linedelimiterdec Decimal value used to indicate the end of a line.
Line Delimiter linedelimiterlength Specifies a fixed length (number of characters) for each line.
Length Example: 80 (80 characters).

Values: Minimum: 0. Maximum: 32768.

Note: The following parameters are NOT mutually exclusive.
Page Delimiter At pagedelimiteratend Indicates whether the page delimiter is located at the end of the
End page:

Yespage delimiter located at end of page

Nopage delimiter located at beginning of page
Line Delimiter Delete linedelimiterdelete Line delimiter is deleted from the Normalized data. Text view
is always without line delimiter.
Page Delimiter pagedelimiterdelete Page delimiter is deleted from the Normalized data. Text view
Delete is always without line delimiter.
Page Delimiter Pos pagedelimiterpos Indicates in which column of the line the delimiter is located.
Optional. Default: 0 (delimiter located at beginning of line).
Max Chars in Line maxcharsinline Maximum number of characters allowed in a line. If this value
is exceed, an error occurs.

Values: Minimum: 0. Maximum: 32768.

Default: 1000.
Max Lines in Page maxlinesinpage Maximum number of lines allowed in a page. When this
maximum is reached, a new page is started. (This parameter
can be used to make additional page breaks beyond those
made by Page Delimiter parameters.)

Values: Minimum: 0. Maximum: 32768.

Default: 1000.

Chapter 2 Online Facilities 349

Report Cliques

Table 152 Decollation ParametersUnique to Text Report Cliques (part 2 of 2)

Name of Parameter
Name of Parameter Specified in the
in the DO Screen TRANSTO Member Description
Line Delimiter Type linedelimitertype Type of line delimiter used for the report. Mandatory. Valid
values are:

delimited Each line ends with a line delimiter according

to the line delimiter parameters. Default.

rdw Variable length data, each line starts with 4 bytes:

xxyy, where:

xx is the record length

yy are binary zeros.

fixed all lines have the same length, based on Line

Delimiter Length parameter.

none all page is one line.

Add Line Feed addlinefeed Indicates whether to add line feed at end of each line. Optional.
Valid values are:

Yes add line feed at end of each line. This value is

needed if the data does not have line feed (for example,
with fixed length data).
No Do not add line feed. Default.

Table 153 Rendering ParametersUnique to Text Report Cliques

Name of Parameter
Name of Parameter Specified in the
in the DO Screen TRANSTO Member Description
Font File Name fontfilename Name of the font file that is used for text reports.

Default: Determined according to the Report Encoding and

Report Language parameters.

(For example, when the encoding is Latin 1 the default file name
is cour.ttf, which is the True Type file name of Courier New).
Font Name fontname The name of the font that is used for text reports. When a true
type font collection (TTC) is specified for the Font File Name, this
parameter must be specified.
Font Size fontsize The size of the font in points.

Valid values are: Minimum: 1. Maximum: 99. Optional. Default is

10.

350 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Parameters Unique to Xerox Report Cliques

NOTE
The following parameters are required. Because there are no default values you must supply
values.

Jsl nameJSL file name.

Jde nameJDE section name in the JSL.

Report Clique parameters that are unique to Xerox reports are described in Table 154.

Table 154 Parameters Unique to Xerox Report Cliques (part 1 of 3)

Name of Parameter
Name of Parameter Specified in the
in the DO Screen TRANSTO Member Description
Record Delimiter xeroxrecdelim Input report record type. One type (RDW) is used by all
reports during decollation. Mandatory.

Valid values are:

rdw Variable-length data. Default. Each record starts

with xxyy, where

xx is the record length

yy are binary zeros.

fixed Record length is taken from the start JSL statement:

RECORD LENGTH = number.

Note: In OS/390 fixed files are processed as rdw.

Jsl Name xeroxjslname JSL file name. Mandatory.
Jde Name xeroxjdename JDE section name in the JSL. Mandatory.

Chapter 2 Online Facilities 351

Report Cliques

Table 154 Parameters Unique to Xerox Report Cliques (part 2 of 3)

Name of Parameter
Name of Parameter Specified in the
in the DO Screen TRANSTO Member Description
SysCatalog Name xeroxsyscatalogname Name of the member containing references to other JSL
resources that are referenced by the report. Optional. Default:
syscatlg.

If the JSL resource referenced by the report refers to a

JDE/PDE that is not found in the JSL, a line must be added to
the syscatlg resource located in the default resource directory,
installation_folder\transformer\res.

Example:

SYSCATTYPE=PDE,RESNAME=PP0010,FILE=PDE001,CRD
ATE=1997250,CRT IME=132200,SIZE=0,PATH='PDE001.JSL';

In this example, the JDE/PDE name is PP0010, located in the

PDE001 JSL file.
DEBUG debug Specifies whether debug messages are sent to a file. Optional.
Valid values: Yes or No. Default: No.
Debug File Name debugfile Name of the file that receives debug messages. Optional.
Default: None.
Error File Name errorfile Name of the file that receives error messages. Optional.
Default: None.
Form X Offset formxoffset Number of pixels to shift the page form horizontally.
Negative numbers shift the page left, and positive numbers
shift the page right. Optional. Default: 0.
Form Y Offset formyoffset Number of pixels to shift the page form vertically. Negative
numbers shift the page up, and positive numbers shift the
page down. Optional. Default: 0.
Page Data X Offset pagedataxoffset Number of pixels to shift only the data in the page
horizontally (the overlays do not move). Negative numbers
shift the data left, and positive numbers shift the data right.
Optional. Default: 0.
Page Data Y Offset pagedatayoffset Number of pixels to shift only the data in the page vertically
(the overlays do not move). Negative numbers shift the data
up, and positive numbers shift the data down. Optional.
Default: 0.
Line Advance xeroxlcdslineadvancem Method for calculating the line height. Optional. Valid values
Method ethod are:

maxheight of the largest font in the line. Default.

lastheight of the last font in the line
Report Identifier report_id ID of a report that needs special handling. Only use this
parameter if requested by BMC Software Customer Support.
Optional. No default.

352 CONTROL-D and CONTROL-V User Guide

 Report Cliques

Table 154 Parameters Unique to Xerox Report Cliques (part 3 of 3)

Name of Parameter
Name of Parameter Specified in the
in the DO Screen TRANSTO Member Description
Scan Origin point xeroxscanorigin A Xerox printer has an origin point on the physical page that
is used as a reference point for metacode. For example, on
9790 printers, this origin point is scan=22 and dot=100. These
value may differ on your printer. If your forms are not aligned
with the line-data, then try adjusting the origin point
parameters (see Dot Origin point). Optional.
Default: Scan Origin point=22.
Dot Origin point xeroxdotorigin A Xerox printer has an origin point on the physical page that
is used as a reference point for metacode. On 9790 printers,
this origin point is scan=22 and dot=100. These value may
differ on your printer. If your forms are not aligned with the
line-data, then try adjusting the origin point parameters (see
Scan Origin point). Optional.
Default: Dot Origin point = 100.

Exiting the CONTROL-D Report Clique Definition Screen

1 After you have defined or modified the parameters for the Report Clique, enter
one of the following commands:

Table 155 Exiting the Report Clique Definition Screen Commands

Command Description
SAVE Save the Report Clique, even if no actual changes were made to any
parameters. The CONTROL-D Report Clique Save window is
displayed (see Figure 169).
END Keep changes made to the parameters of the Report Clique and
return to the CONTROL-D Reports Cliques List screen. If any
changes were made, the CONTROL-D Report Clique Save window
is displayed (see Figure 169). If no changes were made, you are
immediately returned to the CONTROL-D Reports Cliques List
screen.
CANCEL Do not keep the changes made to the parameters of the Report
Clique and return to the CONTROL-D Reports Cliques List screen.

If you have either entered the SAVE command, or the END command when actual
changes have been made, the CONTROL-D Report Clique Save window is displayed
(Figure 169). Otherwise, you are returned to the CONTROL-D Reports Cliques List
screen.

Figure 169 CONTROL-D Report Clique Save Window

--------------- CONTROL-D REPORT CLIQUE FORMAT XRX ---------(DO.Z)
COMMAND ===> SCROLL===> CRSR
----- Property ------- -------- Value ----------------- --C

Chapter 2 Online Facilities 353

Resource Sets

Include Ext++
Include Int| |
4. Renderin| DO YOU WANT TO SAVE CHANGES? (Y/N) |
Half Tone | |
XResolution| REPORT CLIQUE NAME: |
YResolution| |
Rotation ++
0/90/180/270
Pdf Resolution = 300
Max Render Pages = 2000
Font Mapping Table Name = FONTMAP N
5. Html Parameters
Background Image Url = N
Use EOT Fonts = Y (Y/N)
Use PFR Fonts = Y (Y/N)
X Offset = 0
Y Offset = 0
Background Color = White
White/Black/Blue/Gray/Red/Yellow/Brown/
Aque/LawnGreen/Beige/Green
17.41.35
18.07.38

2 If you are saving the Report Clique, do the following in the CONTROL-D Report
Clique Save window:

A Type Y in the DO YOU WANT TO SAVE CHANGES? field.

B For a new Report Clique, type a name for the Report Clique in the REPORT
CLIQUE field.

C Press Enter. The changes you have made are saved, and you are returned to the
CONTROL-D Reports Cliques List screen.

Resource Sets
This option allows you to view or delete Resource Set records that have been created
during the transformation process.

During the report transformation process, a special Resource Set record associated
with the report is created in the Permanent User File, whose key is stored in an
associated SYSDATA record. The Resource Set record references all resources used
by the decollated report. For information on how Resource Sets are used in the report
transformation process, see Print Stream Reports Using Transformation on
page 808.

Entry Panel
After you select option 2 from the CONTROL-D Objects Entry Panel, the
CONTROL-D Resource Sets Entry Panel is displayed.

354 CONTROL-D and CONTROL-V User Guide

 Resource Sets

Figure 170 CONTROL-D Resource Sets Entry Panel

--------------------- CONTROL-D RESOURCE SETS ENTRY PANEL ---------------(DO.2)
COMMAND ===>

JOB NAME ===> Job name or mask

RESOURCE NAME ===> Resource name or mask

RESOURCE TYPE ===> Resource type

FILL IN THE SELECTION CRITERIA AND PRESS ENTER 17.55.32

To display all of the Resource Sets: Leave all of the selection criteria fields blank,
then press Enter. The CONTROL-D Resource Sets List screen is displayed listing all
of the Resource Sets.

To display a selected set of the Resource Sets: Type a value in at least one of the
selection criteria fields as described in Table 147, then press Enter. The
CONTROL-D Resource Sets List screen is displayed listing the set of Resource Sets
that you selected.

Table 156 Resource Sets Selection Criteria Fields

Field Description
JOB NAME The name or mask for the job name related to the Resource Sets to be
displayed.
RESOURCE NAME The name or mask for the resource name referenced by the Resource
Sets to be displayed.
RESOURCE TYPE The type of resource referenced by the Resource Sets to be displayed.

Resource Sets List Screen

After selecting the selection criteria from the CONTROL-D Resource Sets Entry Panel,
the CONTROL-D Resource Sets List screen is displayed with the set of Resource Sets
you selected.

Chapter 2 Online Facilities 355

Resource Sets

Figure 171 CONTROL-D Resource Sets List

------------------------ CONTROL-D RESOURCE SETS LIST ------------------(DO.T)
COMMAND ===> SCROLL===> CRSR
OPT -- JOB -------------- CREATED ------------- COUNT -----
AFP01 18/12/01 14:53 B6E73E74 6C547E00
AFP02 11/12/01 16:22 B6DE8533 21128D80
AFP03 29/11/01 18:28 B6CF8AED 9C356740
XRX01 29/11/01 18:31 B6CF8BA8 B7A07800
XRX02 29/11/01 19:01 B6CF9252 3C61F500
XRX03 02/12/01 13:17 B6D30B1D F0CF1740

OPTIONS: S SELECT D DELETE 18.03.01

Options of the CONTROL-D Resource Sets List

For existing Resource Set definitions, you have the option to either select or delete a
Resource Set.

To request one of the following options, type the option in the OPT field to the left of
the Resource Set name, and press Enter.

Table 157 Options of the CONTROL-D Resource Sets List

Option Description
S (SELECT) Display the CONTROL-D Resources List screen for the selected
Resource Set. Only one Resource Set can be selected at a time.
D (DELETE) Delete a Resource Set. Displays a confirmation window.

CONTROL-D Resources List Screen

After selecting a Resource Set on the Resource Sets List screen, the CONTROL-D
Resources List screen is displayed with the list of resources in the selected Resource
Set.

356 CONTROL-D and CONTROL-V User Guide

 Resource Sets

Figure 172 CONTROL-D Resources List Screen for Resource Sets

-------------------------- CONTROL-D RESOURCES LIST --------------------(DO.R)
COMMAND ===> SCROLL===> CRSR
OPT -- NAME ------------- CREATED ----- TYPE -- FORMAT -- CHECK SUM -- VERS ---
AFPSAMP 18/12/01 02:53 CLQ 02624640 01
C0BICOSH 29/11/01 17:23 FNT AFP 0189E9B3 01
C0OCRB12 29/11/01 15:17 FNT AFP 98ABD182 01
C0UN5510 29/11/01 17:23 FNT AFP 2A737E07 01
C0UN6718 29/11/01 17:23 FNT AFP 31C20748 01
C0420080 29/11/01 17:23 FNT AFP 590806D5 01
F1B00057 29/11/01 16:21 FDE AFP 0097E52E 01
O1B00067 29/11/01 17:23 OLY AFP 0042F015 01
T1AAB001 29/11/01 15:17 CCP AFP 166BF2C4 01
T1BICOSH 29/11/01 17:23 CCP AFP 00102BD6 01
T1V10500 29/11/01 17:23 CCP AFP 1821E26D 01
======= >>>>>>>>>>>>>>>> E N D O F L I S T <<<<<<<<<<<<<<<< ======

OPTIONS: S SELECT 10.38.57

Options of the CONTROL-D Resources List Screen

To request one of the following options, type the option in the OPT field to the left of
the resource name, and press Enter.

Table 158 Options of the CONTROL-D Resource Sets List

Option Description
S (SELECT) Display the contents of the resource (screen DO.R.Z for all resources
other than CLQ resources). For CLQ resources, the Report Clique
parameters of the resource are displayed (screen DO.Z). For non-
CLQ resources, the resource contents are displayed in hexadecimal
mode.

For a description of the parameters of the CLQ type resource, see

CONTROL-D Report Clique Definition Screen on page 332.

Exiting the CONTROL-D Resources List Screen

Press PF03/PF15 (END) to exit the CONTROL-D Resources List Screen.

Chapter 2 Online Facilities 357

Resources

Resources
This option allows you to view or delete resources, other that Report Clique
resources, that are referenced by Resource Sets that have been created during the
transformation process.

During the report transformation process, a special Resource Set record associated
with the report is created in the Permanent User File, whose key is stored in an
associated SYSDATA record. The Resource Set record references all resources used
by the decollated report. For information on how Resource Sets are used in the report
transformation process, see Print Stream Reports Using Transformation on
page 808.

Entry Panel
After you select option 3 from the CONTROL-D Objects Entry Panel, the
CONTROL-D Resources Entry Panel is displayed.

Figure 173 CONTROL-D Resources Entry Panel

----------------------- CONTROL-D RESOURCES ENTRY PANEL -----------------(DO.3)
COMMAND ===>

RESOURCE NAME ===> Resource name or mask

RESOURCE TYPE ===> Resource type
REPORT FORMAT ===> 1.AFP 2.XRX
DATE FROM ===> TO Resource creation date

FILL IN THE SELECTION CRITERIA AND PRESS ENTER 16.13.36

To display all of the Resource Names: Leave all of the selection criteria fields
blank, then press Enter. The CONTROL-D Resources List screen is displayed
listing all of the resources.

To display a selected set of the Resource Names: Type a value in at least one of
the selection criteria fields as described in Table 159, then press Enter. The
CONTROL-D Resources List screen is displayed listing the set of resources that
you selected.

358 CONTROL-D and CONTROL-V User Guide

 Resources

Table 159 Resources Selection Criteria Fields

Field Description
RESOURCE NAME The name or mask for the resources to be displayed. From 1 through
12 characters. Valid characters are a-z, A-Z, 0-9, - (hyphen), and _
(underscore).
RESOURCE TYPE The type resource referenced by the resources to be displayed.
REPORT FORMAT The format of the resources to be displayed. Valid values are:

1 (AFP)Advanced Function Printing, Full AFPDS (AFP type 5)

2 (XRX)Xerox report, LCDS, or Metacode.
DATE FROM and The date range within which resources were created.

DATE TO

Resources List Screen

After selecting the selection criteria from the CONTROL-D Resources Entry Panel,
the CONTROL-D Resources List screen is displayed with the set of resources you
selected.

Figure 174 CONTROL-D Resources List for Resources

-------------------------- CONTROL-D RESOURCES LIST --------------------(DO.R)
COMMAND ===> SCROLL===> CRSR
OPT --- NAME ----------- CREATED ----- TYPE -- FORMAT -- CHECK SUM -- VERS ---
RESOURC1 04/02/02 18:22 CAT XRX 1883B89E 01
RESOURC2 21/02/02 17:49 CAT XRX 0E40C8F6 01
RESOURC3 04/03/02 19:25 CAT XRX 14102223 01
RESOURC4 13/03/02 18:21 CAT XRX 13EEE507 01
RESOURC5 06/02/02 13:53 CCP AFP 166BF2C4 01

OPTIONS: S SELECT D DELETE 13.20.03

Options of the CONTROL-D Resources List

For existing resource definitions, you have the option to either select or delete a
definition.

Chapter 2 Online Facilities 359

Clique Resources

To request one of the following options, type the option in the OPT field to the left of
the resource name, and press Enter.

Table 160 Options of the CONTROL-D Resources List

Option Description
S (SELECT) Display the resource contents in hexadecimal mode (screen DO.R.Z
for all resources other than CLQ resources).
D (DELETE) Delete a resource. Displays a confirmation window.

Exiting the CONTROL-D Resources List Screen

Press PF03/PF15 (END) to exit the CONTROL-D Resources List Screen.

Clique Resources
This option allows you to view Report Clique resources that are referenced by
Resource Sets that have been created during the transformation process.

During the report transformation process, a special Resource Set record associated
with the report is created in the Permanent User File, whose key is stored in an
associated SYSDATA record. The Resource Set record references all resources used
by the decollated report. For information on how Resource Sets are used in the report
transformation process, see Print Stream Reports Using Transformation on
page 808.

Entry Panel
After you select option 4 from the CONTROL-D Objects Entry Panel, the
CONTROL-D Clique Resources Entry Panel is displayed.

360 CONTROL-D and CONTROL-V User Guide

 Clique Resources

Figure 175 CONTROL-D Resources Entry Panel

------------------- CONTROL-D CLIQUE RESOURCES ENTRY PANEL --------------(DO.4)
COMMAND ===>

RESOURCE NAME ===> Clique resource name or mask

DATE FROM ===> TO Resource creation date

FILL IN THE SELECTION CRITERIA AND PRESS ENTER 16.13.36

To display all of the Clique Resource Names: Leave all of the selection criteria
fields blank, then press Enter. The CONTROL-D Resources List screen is displayed
listing all of the resources.

To display a selected set of the Clique Resource Names: Type a value in at least
one of the selection criteria fields as described in Table 161, then press Enter. The
CONTROL-D Resources List screen is displayed listing the set of resources that
you selected.

Table 161 Clique Resources Selection Criteria Fields

Field Description
RESOURCE NAME The name or mask for the resources to be displayed. From 1 through
12 characters. Valid characters are a-z, A-Z, 0-9, - (hyphen), and _
(underscore).
DATE FROM and The date range within which resources were created.
DATE TO

Resources List Screen

After selecting the selection criteria from the CONTROL-D Clique Resources Entry
Panel, the CONTROL-D Resources List screen is displayed with the set of Clique
Resources you selected.

Chapter 2 Online Facilities 361

Clique Resources

Figure 176 CONTROL-D Resources List for Clique Resources

-------------------------- CONTROL-D RESOURCES LIST --------------------(DO.R)
COMMAND ===> SCROLL===> CRSR
OPT --- NAME ----------- CREATED ----- TYPE -- FORMAT -- CHECK SUM -- VERS ---
CLIQUE0 06/02/02 12:11 CLQ 02606E06 01
CLIQUE1 21/02/02 05:49 CLQ 03D33586 01
CLIQUE2 12/03/02 06:43 CLQ 04291467 01
CLIQUE3 19/02/02 06:49 CLQ 0268D40E 01
CLIQUE4 04/03/02 07:25 CLQ 0448B58B 01
CLIQUE5 07/02/02 11:18 CLQ 02692FF1 01

OPTIONS: S SELECT D DELETE 13.20.03

Options of the CONTROL-D Resources List

For existing Clique Resource definitions, you have the option to either select or delete
a definition.

To request one of the following options, type the option in the OPT field to the left of
the Clique Resource name, and press Enter.

Table 162 Options of the CONTROL-D Resources List

Option Description
S (SELECT) Display the contents of the CLQ (Clique) resource (screen DO.Z).
The contents of the CLQ resource cannot be edited.

For a description of the parameters of the CLQ type resource, see

CONTROL-D Report Clique Definition Screen on page 332.
D (DELETE) Delete a CLQ resource. Displays a confirmation window.

Exiting the CONTROL-D Resources List Screen

Press PF03/PF15 (END) to exit the CONTROL-D Resources List Screen.

362 CONTROL-D and CONTROL-V User Guide

 Approval and Subscribe Objects

Approval and Subscribe Objects

This option allows displaying and deleting Approval and Subscribe objects that are
created during report decollation. Approval and Subscribe processing is performed
by the CONTROL-D/WebAccess Business Information (BIS) Server.

Approval processing allows you to define a set of report processing rules that specify
a chain of users, at different levels, who must review and approve reports. Subscribe
processing enables notification emails to be sent according to a subscription list.

The CONTROL-D monitor creates Approval and Subscribe objects for each report
that use the DO APPROV and DO SUBSCR parameters in the decollation mission
definition. For more information about defining these objects in decollation missions,
see DO BACKUP: Decollating Parameter on page 452 and DO USER: Decollating
Parameter on page 513.

The CONTROL-D/WebAccess BIS Server uses the objects to identify new reports that
are candidates for Approval and Subscribe processing. After a report is processed by
the BIS server, it updates the report's user record, and the object is deleted.

For more information about defining Approval and Subscribe see the chapter about
managing approvals in the CONTROL-D/WebAccess Server Administrator Guide.

Entry Panel
After you select option 5 from the CONTROL-D Objects Entry Panel, the
CONTROL-D Approvals and Subscribe Entry Panel is displayed.

Figure 177 CONTROL-D Approvals and Subscribe Entry Panel

---------------- CONTROL-D APPROVALS AND SUBSCRIBE ENTRY PANEL -------------(DO.5)
COMMAND ===>

RECIPIENT ===> Recipient or mask

JOB NAME ===> Job name or mask
CATEGORY ===> Category or mask
REPORT NAME ===>
Report name or mask
DATE FROM ===> TO Object creation date
APPROVAL ===> Approval (Y/N)
SUBSCRIBE ===> Subscribe (Y/N)

FILL IN THE SELECTION CRITERIA AND PRESS ENTER 19.03.45

To display all of the Approval and Subscribe objects: Leave all of the selection
criteria fields blank, then press Enter. The CONTROL-D Approvals and Subscribe
object list screen is displayed, listing all of the Approval and Subscribe objects.

Chapter 2 Online Facilities 363

Approval and Subscribe Objects

To display a selected set of the Approval and Subscribe objects: Type a value in
at least one of the selection criteria fields as described in Table 163, then press
Enter. The CONTROL-D Approvals and Subscribe object list screen is displayed
listing the set of CONTROL-D Approval and Subscribe objects that you selected.

Table 163 Approvals and Subscribe Object Selection Criteria Fields

Field Description
RECIPIENT The name or mask of the recipient for reports awaiting post-
processing.
JOB NAME The name or mask of the job created for reports awaiting post-
processing.
CATEGORY The name or mask of the category for reports waiting post-
processing.
REPORT NAME The initial status of the report visibility, as defined in the mission or
permanent file.
DATE FROM and The date range within which reports awaiting post-processing were
DATE TO created.
APPROVAL Whether or not Approval post-processing has been ordered. Valid
values are Y (Yes) and N (No).
SUBSCRIBE Whether or not Subscribe post-processing has been ordered. Valid
values are Y (Yes) and N (No).

Approvals and Subscribe Object List Screen

After choosing the selection criteria from the CONTROL-D Approvals and Subscribe
Entry Panel, the CONTROL-D Approvals and Subscribe object list screen is displayed
with the set of Approvals and Subscribe objects that you selected.

364 CONTROL-D and CONTROL-V User Guide

 Approval and Subscribe Objects

Figure 178 CONTROL-D Approvals and Subscribe Object List

------------- CONTROL-D APPROVALS AND SUBSRCIBE OBJECT LIST ------------(DO.W)
COMMAND ===> SCROLL===> CRSR
OP AP S ---CREATED---- ---RECORD-ID----- --USER-- --JOB--- ------CATEGORY------
C 21/01/08 20:52 C1D5047B ADB4CB84 Q23 Q23AWF WFTEST1
Report: WF-REGULAR
C 22/01/08 11:53 C1D5CDED AB377244 Q23 Q23AWF WFTEST1
Report: WF-REGULAR
C 22/01/08 12:00 C1D5CF7A 68877AC3 Q23 Q23AWF WFTEST1
Report: WF-REGULAR
C 22/01/08 12:04 C1D5D029 A64E77CB Q23 Q23AWF WFTEST1
Report: WF-REGULAR
C 22/01/08 15:55 C1D60407 8BA66E01 Q23 Q23AWF WFTEST1
Report: WF-REGULAR
C 23/01/08 17:52 C1D75FF7 203BA984 Q23 Q23AWF1 WFS2SYSOUT
Report: WF-REGULAR1
C 23/01/08 17:52 C1D75FF7 30EDC884 Q23 Q23AWF1 WFS2SYSOUT
Report: WF-SYSDATA1
C 23/01/08 17:52 C1D75FF7 4568934B Q23 Q23AWF1 WFS2SYSOUT
Report: WF-REGULAR2
C 23/01/08 17:52 C1D75FF7 4AC5DC4B Q23 Q23AWF1 WFS2SYSOUT
Report: WF-SYSDATA2
C 23/01/08 17:55 C1D760A7 1213FE81 Q23 Q23AWF1 WFS2SYSOUT
Report: WF-REGULAR1
OPTIONS: D DELETE 18.30.04

Table 164 Approvals and Subscribe Object List Parameters

Field Description
AP The Approval status. Valid status values are C (Candidate) or blank.
S Subscribe status. Valid status values are C (Candidate) or blank.
CREATED The date and time the object was created.
RECORD ID The record ID of the report pointed to by the object.
USER The recipient of the report pointed to by the object.
JOB The job name of the report pointed to by the object.
CATEGORY The category of the report pointed to by the object.
Report The name of the report pointed to by the object.

Options of the CONTROL-D Approvals and Subscribe Object List

For existing CONTROL-D Approval and Subscribe objects, you have the option to
delete a object.

To request the option, type the option in the OPT field to the left of the line, and press
Enter.

Table 165 Options of the CONTROL-D Approvals and Subscribe Object List
Option Description
D (DELETE) Delete an Approvals or Subscribe object. Displays a confirmation
window.

Chapter 2 Online Facilities 365

Condition and Resource Handling Facility

Exiting the CONTROL-D Resources List Screen

Press PF03/PF15 (END) to exit the CONTROL-D Approvals and Subscribe Object List
Screen.

Condition and Resource Handling Facility

Options 4 and 7 in the IOA Primary Option menu are directly related to the handling
of IOA conditions and CONTROL-M resources. The screens displayed by these
options are discussed on the following pages.

IOA Conditions/Resources Screen

The IOA Conditions/Resources screen is accessed through Option 4 of the IOA
Primary Option menu. It displays information from the IOA Conditions file, which
contains the list of all existing prerequisite conditions, and the CONTROL-M
Resources file, which contains the list of Quantitative resources and Control
resources. The IOA Conditions/Resources screen enables you to

view IOA prerequisite conditions

view CONTROL-M Quantitative resources
add or delete prerequisite conditions or resources or both
change the available quantity of CONTROL-M Quantitative resources

For a description of prerequisite conditions, see Prerequisite Condition Concept on

page 70.

NOTE
Prior to version 6.0.00 a single file, the IOA Conditions/Resources file, contained all IOA
conditions and all Control and Quantitative resources. As of version 6.0.00, the IOA
Conditions/Resources file has been replaced by two files:

IOA Conditions file: Contains all IOA conditions.

CONTROL-M Resources file: Contains all Control and Quantitative resources.

To enter the IOA Condition/Resources screen, select option 4 on the Primary Option
menu.

366 CONTROL-D and CONTROL-V User Guide

 IOA Conditions/Resources Screen

Figure 179 IOA Conditions/Resources Screen

-------------------------- IOA CONDITIONS/RESOURCES ------------------------(4)
COMMAND ===> SCROLL ===> CRSR
PREFIX ===> COND Y CONTROL Y RES Y STAT Y DATE 0909 - 0909
OPT TYPE CONDITION/RESOURCE DATE USE QUANTITY MAX *P RBA IOAID
CONTROL CONTROLM E (00000) 01
RESOURCE TAPEP 0003 0003
RESOURCE CPU1 0098 0100
RESOURCE CPU2 0197 0200
RESOURCE TAPEP Q 0002 (00091) 01
RESOURCE CPU1 Q 0002 (00091) 01
RESOURCE CPU2 Q 0003 (00092) 01
RESOURCE TAPEP R 0002 1 (00093) 01
COND BR-BRIVPCC-ENDED-OK STAT
COND BR-BRCC0001-ENDED-OK STAT
COND BR-BRCC0002-ENDED-OK STAT
COND BR-BRCC0003-ENDED-OK STAT
COND BR-BRCCIND-ENDED-OK STAT
COND BR-BRUPDT02-ENDED-OK STAT
COND BR-BRREP001-ENDED-OK STAT
COND BR-BRREP002-ENDED-OK STAT
COND GL-GLINP001-ENDED-OK STAT
COND EBD-APPL-STARTED STAT
COND CICS-PROD-IS-UP STAT
OPTIONS: D DELETE C CHANGE COMMANDS: ADD 14.07.08

To return to the IOA Primary Option menu, press END (PF03/PF15).

Fields of the IOA Conditions/Resources Screen

The information displayed in each screen line is:

Table 166 Fields of the IOA Conditions/Resources Screen (part 1 of 2)

Field Description
OPT Option to be activated on the condition or resource.
TYPE Type of condition or resource:

COND Prerequisite condition

CONTROL Control resourcea
RESOURCE Quantitative resourcea
CONDITION/RESO Name of the condition or resource.
URCE
DATE Original date reference of a prerequisite condition (format mmdd or
ddmm depending on the site standard, or the value STAT).
For sites where CONTROL-M is active:

Chapter 2 Online Facilities 367

IOA Conditions/Resources Screen

Table 166 Fields of the IOA Conditions/Resources Screen (part 2 of 2)

Field Description
USE Resource usage indicator for Control or Quantitative resources.
Valid values depend on the type of resource.

Valid values for Control resources:

E Resource is being used in Exclusive mode.

S Resource is being used in Shared mode.

Valid values for Quantitative resources. Valid values:

blank Line indicates the initial definition for the resource.

Q Line indicates an instance of resource usage.
R Line indicates an unfulfilled critical path request (that is,
request with an *-type priority) for the resource.
QUANTITY Quantity of a Quantitative resource. What the quantity represents
depends on the value in the USE field, as follows:
Use Quantity
B Quantity available. If the maximum quantity is
more than 1 but only 1 is available, 0001 is
displayed in pink (on color terminals). If the
maximum quantity is more than 1 but none is
available, 0000 is displayed in red (on color
terminals).
Q Quantity in use by the particular process.
R Quantity requested by the particular
process, but unfulfilled.
MAX Maximum available quantity of a Quantitative resource.
*P Priority of the job requesting a CONTROL-M resource using *-type
priority. For more information, see PRIORITY: Runtime Scheduling
Parameter on page 592.`
RBA Internal CONTROL-M ID (relative block address) of the job
currently holding a CONTROL-M resource. An RBA value of 000000
indicates that the resource was added manually.
IOAID ID of the IOA installation that is using the particular Control or
Quantitative resource. This value is significant when multiple IOA
installations share the same resources.
a
Applicable only at sites where CONTROL-M is active.

368 CONTROL-D and CONTROL-V User Guide

 IOA Conditions/Resources Screen

Specifying Retrieval Criteria

You can control the type and amount of information displayed in the screen by
specifying retrieval criteria.

Table 167 IOA Conditions/Resources Retrieval Criteria

Criteria Description
PREFIX prefix If specified, limits the display to conditions with the specified prefix.

To display only conditions containing a specific string, enter the

string preceded by an *.

Example:

If *OK is entered, the following conditions are included in the

display:

UPDATE-ENDED-OK
OK-RUN
OK
COND Determines whether prerequisite conditions are displayed. Valid
values are:
Y (Yes) Display prerequisite conditions. Default.
N (No) Do not display prerequisite conditions.

DATE from to Limits the display of prerequisite conditions to the selected date
range. Valid values are:
from Earliest date in the date range, in mmdd or ddmm format
(depending on the site standard). The default value is three days
prior to the current date. This default can be modified in the
Profile member by the INCONTROL administrator.
to Latest date in the date range, in mmdd or ddmm format
(depending on the site standard). The default value is the current
date.
STAT Determines whether prerequisite conditions with a date value of
STAT are displayed. (Applies only if Y is specified for COND.) Valid
values are:
Y (Yes) Include prerequisite conditions with a date value of
STAT.
N (No) Do not include prerequisite conditions with a date
value of STAT.
For sites where CONTROL-M is active:
CONTROL Determines whether Control resources are displayed. Valid values
are:
Y (Yes) Display Control resources. Default.
N (No) Do not display Control resources.

RES Determines whether Quantitative resources are displayed. Valid

values are:
Y (Yes) Display Quantitative resources. Default.
N (No) Do not display Quantitative resources.

Chapter 2 Online Facilities 369

IOA Conditions/Resources Screen

Adding Conditions and Resources The ADD Command

The ADD command adds conditions to the IOA Conditions file and adds resources to
the CONTROL-M Resources file. Type this command in the COMMAND field, and
press Enter. Format of the command is:

ADD type

where type is one of the following:

COND Add a prerequisite condition. Special care must be taken when adding
prerequisite conditions, because added conditions can trigger job submission.

RESOURCE/RES Add a Quantitative resource. Only authorized personnel

should add Quantitative resources.

CONTROL/CON Add a Control resource. A Control resource entry may be

added manually even if a job is holding the resource. Only authorized personnel
should add Control resources.

When the ADD command is entered, an appropriate window is opened. The window
shown below opens when ADD COND is entered.

Figure 180 IOA Conditions/Resources COND Window

-------------------------- IOA CONDITIONS/RESOURCES ------------------------(4)
COMMAN +---------------------------------------------------------+ L ===> CRSR
PREFIX | PLEASE FILL IN COND NAME, DATE AND PRESS ENTER | 0909 - 0909
OPT TY | | A IOAID
CO | NAME ===> DDMM ===> | 00) 01
RE | |
RE +---------------------------------------------------------+
RE
RESOURCE TAPEP Q 0002 (00091) 01
RESOURCE CPU1 Q 0002 (00091) 01
RESOURCE CPU2 Q 0003 (00092) 01
RESOURCE TAPEP R 0002 1 (00093) 01
COND BR-BRIVPCC-ENDED-OK 0909
COND BR-BRCC0001-ENDED-OK 0909
COND BR-BRCC0002-ENDED-OK 0909
COND BR-BRCC0003-ENDED-OK 0909
COND BR-BRCCIND-ENDED-OK 0909
COND BR-BRUPDT02-ENDED-OK 0909
COND BR-BRREP001-ENDED-OK 0909
COND BR-BRREP002-ENDED-OK 0909
COND GL-GLINP001-ENDED-OK 0909
COND EBD-APPL-STARTED 0909
COND CICS-PROD-IS-UP STAT
OPTIONS: D DELETE C CHANGE COMMANDS: ADD 13.52.38

370 CONTROL-D and CONTROL-V User Guide

 IOA Conditions/Resources Screen

Fill in the window fields as described below according to the specified ADD
command:

Table 168 IOA Conditions/Resources ADD Command Formats

Format Description
ADD COND Enter the name of the prerequisite condition. The current working date
is displayed as the default date. This date can be modified.
ADD RESOURCE Enter the name of the Quantitative resource and the quantity to be
or ADD RESa added.
ADD CONTROL or Enter the name of the Control resource and the control type
ADD CONa (E Exclusive; S Shared).
Note: If a Control resource is manually added with a type of E
(Exclusive), no jobs in WAIT SCHEDULE status that require this
resource are submitted.

If a Control resource is manually added with a type of S (Shared), no

jobs in WAIT SCHEDULE status that require exclusive access to this
resource are submitted.
a
Applicable only at sites where CONTROL-M is active.

After filling in the window, press Enter to add the condition or resource.

To close the window without adding the condition or resource, press the RESET key
(PF04/PF16).

Options of the IOA Conditions/Resources Screen

The following options can be selected for conditions and resources by typing the
option in the OPT field to the left of the resource or condition name and pressing
Enter. Available options are:

Table 169 Options of the IOA Conditions/Resources Screen

Option Description
D (DELETE) Delete a condition or resource from the list. The event is recorded in
the IOA Log file.
C (CHANGEa) Change the maximum available quantity of a Quantitative resource.
The event is recorded in the IOA Log file.
a
applicable only at sites where CONTROL-M is active.

These options are discussed in detail on the following pages.

Chapter 2 Online Facilities 371

IOA Conditions/Resources Screen

Deleting Conditions and Resources The DELETE Option

To delete conditions and/or resources, type D (Delete) in the OPT field to the left of
the conditions and resources being deleted and press Enter.

A confirmation window may be displayed, depending on User profile customization:

By default, conditions and resources are deleted without confirmation from the
user.

The User profile can be customized to display a confirmation window with an

arrow pointing to a delete request (beginning with the first request).

Figure 181 IOA Conditions/Resources DELETE Confirmation Window

-------------------------- IOA CONDITIONS/RESOURCES ------------------------(4)
COMMAND ===> SCROLL ===> CRSR
PREFIX ===> COND Y CONTROL Y RES Y STAT Y DATE 0909 - 0909
OPT TYPE CONDITION/RESOURCE DATE USE QUANTITY MAX *P RBA IOAID
COND SALARY-PRSL01A-OK 0909
COND SALARY-PRSL002-OK 0909 +----------------------+
COND SALARY-PRSL003-OK 0909 | CONFIRM |
D COND CBT-TAPE-ARRIVED 0909 <---------| ASK FOR EACH ONE Y |
D COND KPL-PRKPL03-OK 0909 +----------------------+
COND KPL-PRKPL04-OK 0909
======== >>>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<<< ========

OPTIONS: D DELETE C CHANGE COMMANDS: ADD 18.48.12

If a confirmation window is displayed, fill in the window as follows and press Enter:

Table 170 IOA Conditions/Resources DELETE Confirmation Window Options

(part 1 of 2)
Option Description
CONFIRM Whether to process the delete request. Valid values are:
Y (Yes) Process the request.
N (No) Cancel the request.

372 CONTROL-D and CONTROL-V User Guide

 IOA Conditions/Resources Screen

Table 170 IOA Conditions/Resources DELETE Confirmation Window Options

(part 2 of 2)
Option Description
ASK FOR EACH This line is displayed only if more than one delete is requested. It
ONE determines whether or not individual confirmation is required for each
delete request. Valid values are:

Y (Yes) Individual confirmation is required for each delete

request. The specified CONFIRM value applies only to the current
order or request.

N (No) Individual confirmation is not required for each delete

request. The specified CONFIRM value is applied to all delete
requests. (If CONFIRM is Y, all delete requests are processed; if
CONFIRM is N, no delete request are processed.)

Changing the Quantity of a Resource The CHANGE Option (applicable only if

CONTROL-M is active.)

To request a change to the maximum available quantity of a resource, type

C (Change) in the OPT field to the left of the resource and press Enter. The following
window is opened.

Figure 182 IOA Conditions/Resources CHANGE Option Window

-------------------------- IOA CONDITIONS/RESOURCES ------------------------(4)
COMMAN +---------------------------------------------------------+ L ===> CRSR
PREFIX | PLEASE FILL IN QUANT RES NAME, COUNT AND PRESS ENTER | 0909 - 0909
OPT TY | | A IOAID
CO | NAME ===> TAPEP COUNT ===> | 00) 01
C RE | |
RE +---------------------------------------------------------+
RE
RESOURCE TAPEP Q 0002 (00091) 01
RESOURCE CPU1 Q 0002 (00091) 01
RESOURCE CPU2 Q 0003 (00092) 01
RESOURCE TAPEP R 0002 1 (00093) 01
COND BR-BRIVPCC-ENDED-OK 0909
COND BR-BRCC0001-ENDED-OK 0909
COND BR-BRCC0002-ENDED-OK 0909
COND BR-BRCC0003-ENDED-OK 0909
COND BR-BRCCIND-ENDED-OK 0909
COND BR-BRUPDT02-ENDED-OK 0909
COND BR-BRREP001-ENDED-OK 0909
COND BR-BRREP002-ENDED-OK 0909
COND GL-GLINP001-ENDED-OK 0909
COND EBD-APPL-STARTED 0909
COND CICS-PROD-IS-UP STAT
OPTIONS: D DELETE C CHANGE COMMANDS: ADD 13.52.38

The NAME value in the window is protected and cannot be changed.

The COUNT parameter consists of two values: sign and quantity. Fill in the COUNT
parameter as follows and press Enter:

Chapter 2 Online Facilities 373

IOA Manual Conditions Screen

Table 171 COUNT Parameter Values

Value Description
sign Valid values (one character):

+ (Plus) Add the selected quantity to the current maximum

available quantity to give a new maximum available quantity.

- (Minus) Subtract the selected quantity from the current

maximum available quantity to give a new maximum available
quantity.

' ' (Blank) Set the maximum available quantity to the selected
quantity.
quantity Quantity to be used to adjust the maximum quantity of the resource
(four digits) according to the specified sign. Leading zeros are
required.

IOA Manual Conditions Screen

The IOA Manual Conditions screen displays a list of prerequisite conditions that
should be confirmed manually by operations personnel.

The list of manual conditions is created by utility IOALDNRS. The utility is described
in the INCONTROL for z/OS Utilities Guide. This utility is intended for use at sites
where CONTROL-M and/or CONTROL-V are installed.

The utility scans the jobs in the CONTROL-M Active Jobs file, and/or missions in the
CONTROL-V Active Missions file, for all conditions requested in IN statements that

are not resolved by an OUT statement

are not resolved by ON PGMST or DO COND statements
do not exist in the IOA Conditions file

The utility automatically places the conditions conforming to the above criteria into
the IOA Manual Conditions file. This file is used as a checklist for manual operations
that operations personnel are expected to perform.

To enter the IOA Manual Conditions screen, select option 7 on the IOA Primary
Option menu.

374 CONTROL-D and CONTROL-V User Guide

 IOA Manual Conditions Screen

Figure 183 IOA Manual Conditions Screen

--------------------------- IOA MANUAL CONDITIONS --------------------------(7)
COMMAND ===> SCROLL ===> CRSR
PREFIX ===> PENDING Y ADDED Y STAT Y DATE 0909 - 0909
OPT TYPE CONDITION DATE ADDED
COND USR-GOT-TAX-TAPE 0909
COND DBA-RUN-UPDATE 0909 Y
COND OP-EXTERNAL-TAPE-OK 0909 Y
COND USR-GOT-BANK-TAPE 0909
COND OP-SHUT-THE-SYSTEM 0909
COND DBA-START-MPMXXX 0909
COND USR-GOT-SALARY-TAPE 0909 Y
COND OP-COMMUNICATION-DOWN STAT
======== >>>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<<< ========

OPTIONS: A ADD TO COND/RES LIST (SCREEN 4) E ERASE COMMANDS: NEW 18.33.47

To exit the IOA Manual Conditions screen, press END (PF03/PF15).

Fields of the Manual Conditions Screen

The information displayed on each screen line is:

Table 172 Fields of the IOA Manual Conditions Screen

Field Description
OPT Option to be activated on the condition.
TYPE Type of condition, meaning, COND for prerequisite condition.
CONDITION Condition name.
DATE Date reference of prerequisite condition. Format is either mmdd or
ddmm depending on the site standard, or the date value STAT.
ADDED Indicates whether the condition has been manually added to the IOA
Conditions file. Valid values:

Y (Yes) Condition has been added.

N (No) Condition has not been added.

Specifying Retrieval Criteria

You can control the type and amount of information displayed in the screen by
specifying retrieval criteria.

Chapter 2 Online Facilities 375

IOA Manual Conditions Screen

Table 173 Retrieval Criteria for IOA Manual Conditions Screen

Criteria Description
PREFIX prefix Limits the display to conditions with the selected prefix. Default:
Blank (no limit).

To display only those conditions containing a specific string, enter

the string preceded by an *.

Example:

If *OK is entered, the following conditions are included in the

display:

UPDATE-ENDED-OK
OK-RUN
OK
PENDING Determines whether conditions not yet added are displayed. Valid
values are:
Y (Yes) Display pending conditions.
N (No) Do not display pending conditions.

ADDED Determines whether added conditions are displayed. Valid values

are:
Y (Yes) Display added conditions.
N (No) Do not display added conditions.

STAT Determines whether prerequisite conditions with a date value of

STAT are displayed. Valid values are:
Y (Yes) Display prerequisite conditions with a date value of
STAT.
N (No) Do not display prerequisite conditions with a date
value of STAT.
DATE from to Limits the display of prerequisite conditions to the specified date
range. Valid values are:
from Earliest date in the date range, in mmdd or ddmm format
(depending on the site standard). The default value is three days
prior to the current date.
to Latest date in the date range, in mmdd or ddmm format
(depending on the site standard). The default value is the current
date.

Adding a New Prerequisite Condition NEW COND

Command
To add a prerequisite condition to the IOA Manual Conditions file, type NEW COND
in the COMMAND field and press Enter. A window is opened.

376 CONTROL-D and CONTROL-V User Guide

 IOA Manual Conditions Screen

Figure 184 IOA Manual Conditions Screen NEW COND Window

--------------------------- IOA MANUAL CONDITIONS --------------------------(7)
COMMAN +---------------------------------------------------------+ L ===> CRSR
PREFIX | PLEASE FILL COND NAME AND DATE AND PRESS ENTER | 0909 - 0909
OPT TY | |
CO | NAME ===> MMDD ===> |
CO | |
CO +---------------------------------------------------------+
CO
COND OP-SHUT-THE-SYSTEM 0909
COND DBA-START-MPMXXX 0909
COND USR-GOT-SALARY-TAPE 0909 Y
COND OP-COMMUNICATION-DOWN 0909
======== >>>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<<< ========

OPTIONS: A ADD TO COND/RES LIST (SCREEN 4) E ERASE COMMANDS: NEW 18.33.47

In the NAME field of the window, type the name of the condition to be added. If the
condition has a date other than the current working date, enter the date in the date
field of the window, in the format DDMM or MMDD, depending on the site
standard.

To add the condition, press Enter.

To close the window without adding the condition, press RESET (PF04/PF16).

NOTE
Adding a new condition to the IOA Manual Conditions file does not affect the IOA
Conditions file.

Options of the Manual Conditions Screen

To add a condition to the IOA Conditions file or to erase a condition from the Manual
Conditions file, specify the appropriate option in the OPT field to the left of the
condition name and press Enter. Valid options:

Chapter 2 Online Facilities 377

IOA Manual Conditions Screen

Table 174 Options of the IOA Manual Conditions Screen

Option Description
A (ADD) Add the condition to the IOA Conditions file (Screen 4), and mark it
Added (Y) in the IOA Manual Conditions file. The event is
recorded in the IOA Log file.
E (ERASE) Erase (Delete) a condition from the IOA Manual Conditions file. This
does not affect the IOA Conditions file. This option is discussed in
more detail below.

Erasing (Deleting) Conditions

To erase prerequisite conditions, type E in the OPT field to the left of the condition
names being erased and press Enter.

A confirmation window may be displayed, depending on user profile customization:

By default, conditions are deleted without confirmation from the user.

If, however, the user profile member has been customized accordingly, a
confirmation window is displayed with an arrow pointing to an erase request
(beginning with the first request).

Figure 185 IOA Manual Conditions Screen ERASE Confirmation Window

--------------------------- IOA MANUAL CONDITIONS --------------------------(7)
COMMAND ===> SCROLL ===> CRSR
PREFIX ===> PENDING Y ADDED Y STAT Y DATE 0909 - 0909
OPT TYPE CONDITION DATE ADDED
COND DAILY-PROD-KPL-GO 0909
COND SALARY-GROUP-GO 0909
COND SALARY-PROMPTED-OK 0909 +----------------------+
COND SALARY-TAPE-ARRIVED 0909 | CONFIRM |
E COND PROD-PRUPDT03-GO 0909 <---------| ASK FOR EACH ONE Y |
E COND PROD-INTAPE-OK 0909 +----------------------+
COND OP-START-BACKUP-180D 0909
COND OP-START-PRINT-STD 0909
COND OP-START-RESTORE-ADH 0909
======== >>>>>>>>>>>>>>>> B O T T O M O F L I S T <<<<<<<<<<<<<<<< ========

OPTIONS: A ADD TO COND/RES LIST (SCREEN 4) E ERASE COMMANDS: NEW 18.33.47

If a confirmation window is displayed, fill in the window as follows and press Enter:

378 CONTROL-D and CONTROL-V User Guide

 IOA Log Facility

Table 175 Fields of the IOA Manual Conditions Screen ERASE

Confirmation Window
Field Description
CONFIRM Indicates whether to process the erase (delete) request. Valid values
are:

Y (Yes) Process the request.

N (No) Cancel the request.
ASK FOR EACH This line is displayed only if more than one erase is requested. It
ONE determines whether individual confirmation is required for each
erase request. Valid values are:

Y (Yes) Individual confirmation is required each erase request.

The specified CONFIRM value applies only to the current order
or request.

N (No) Individual confirmation is not required for each erase

request. The specified CONFIRM value is applied to all erase
requests. (If CONFIRM is Y, all erase requests are processed; if
CONFIRM is N, no erase request is processed.)

IOA Log Facility

The IOA Log facility places automatically generated messages, which record every
significant event in the life of a job, rule, or mission, in the IOA Log file. Significant
events recorded in the IOA Log file include normal processing occurrences, such as
mission activated, or completed, as well as error conditions encountered during
processing. Shout facility notifications and user remarks can also be recorded in the
IOA Log file.

IOA Log Screen

The IOA Log screen enables you to view the information contained in the IOA Log
file. To enter the IOA Log screen, select option 5 on the IOA Primary Option menu.
Upon entry, the screen displays the most recent messages currently in the IOA Log
file.

Chapter 2 Online Facilities 379

IOA Log Screen

Figure 186 IOA Log Screen

FILTER: ---------------- IOA LOG --------------------------------(5)
COMMAND ===> SCROLL===> CRSR
SHOW LIMIT ON ==> DATE 080800 - 080800
DATE TIME ODATE USERID CODE ------------- M E S S A G E -------------
080800 092144 080800 M22 SPY254I JOB CT085955 CT085955/01835 SCANNED
080800 092144 080800 M22 TEL208I JOB CT085955 CT085955/01835 ENDED "OK"
080800 092150 080800 M22 SPY254I JOB CT085956 CT085956/01836 SCANNED
080800 092150 080800 M22 TEL208I JOB CT085956 CT085956/01836 ENDED "OK"
080800 092156 080800 IVP SPY254I JOB BRIVPCC BRIVPCC /01843 SCANNED
080800 092157 080800 IVP TEL208I JOB BRIVPCC BRIVPCC /01843 ENDED "OK"
080800 092157 080800 DBA CTM659I FREE OF TASK BRCC0001 ODATE 080800
PERFORMED
080800 092201 080800 M22 SPY281I JOB INTR0004 INTR0004/04371 START
98253.1316 STOP 98253.1316 CPU 0MIN
00.04SEC SRB 0MIN 00.00SEC 0.19
080800 092201 080800 M22 SPY254I JOB INTR0004 INTR0004/04371 SCANNED
080800 092201 080800 M22 TEL206W JOB INTR0004 INTR0004/04371 ABENDED CC
SB37 STEP STEP01
080800 092201 080800 M22 TEL219I JOB INTR0004 INTR0004/04371 ENDED "NOT
OK"
080800 092208 080800 IVP TEL203I JOB BRCC0001 ELIGIBLE FOR RUN
080800 092208 080800 IVP SUB133I JOB BRCC0001 BRCC0002/01958 SUBMITTED
080800 092208 080800 IVP TEL203I JOB BRCC0002 ELIGIBLE FOR RUN
CMDS: SHOW, GROUP, CATEGORY, SHPF 09.43.00

To return to the IOA Primary Option menu, press END (PF03/PF15).

Fields of the IOA Log Screen

Table 176 Fields of the IOA Log Screen (part 1 of 2)

Field Screen
SHOW LIMIT ON Identifies which selection criteria other than yes or no were entered in
the IOA Log Show Screen window (USERID, MEM/MIS, JOBNAME,
CATEGORY, GROUP). For more information, see Filtering the IOA
Log Screen Display on page 383.
DATE Date on which the message was issued.
TIME Time at which the message was issued.
ODATE Original scheduling date of the mission associated with the message.
Format is mmddyy, ddmmyy, or yymmdd, depending on the site
standard.
Note: When the display type is set to RBA display using the DISPLAY
command, the Relative Byte Address (RBA) of the message within the
IOA Log file is displayed instead of the ODATE. For more information
on changing the screen display, see Changing IOA Log Screen
Display Types on page 382.
USERID User ID of the job issuing the message, or user ID of the user writing to
the log.
CODE IOA message code.

380 CONTROL-D and CONTROL-V User Guide

 IOA Log Screen

Table 176 Fields of the IOA Log Screen (part 2 of 2)

Field Screen
MESSAGE Text of the message. If the message is longer than the space available
on the screen, the message is split and continues on the following line.
Messages relating to a job have the following format:

tasktype memname jobname/jobid message

fromdate todate Log information displayed in the screen can be limited to the specified
date range in mmddyy, ddmmyy or yymmdd format, depending on
the site standard. If the DATE or the ODATE value for a message is in
the specified range, the message is included in the IOA Log display.
Valid values are:

fromdate Earliest date in the date range.

todate Latest date in the date range.

Commands of the IOA Log Screen

The following commands can be specified in the COMMAND field:

Table 177 Commands of the IOA Log Screen (part 1 of 2)

Command Description
SHOW The SHOW command activates the specified screen filter, opens the
IOA Log Show Screen window, or opens the Display Filters window,
depending on the format of the command. For more information on
filtering the IOA Log Screen, see Filtering the IOA Log Screen
Display on page 383. Valid formats:

SHOW name Activates the specified filter.

SHOW ? Opens the Display Filters window, which lists all

available filters.

SHOW (PF02/PF14) Opens the IOA Log Show Screen window

for the currently active filter, and allows editing of that filter.

SHOW name EDIT Opens the IOA Log Show Screen window
for the specified filter, and allows editing of that filter.
Note: Reserved filter name DEFAULT can be used to activate or edit
the default filter for the status screen. For example, SHOW
DEFAULT EDIT opens the Show Screen Filter window for the
default filter.

Only jobs conforming to selection criteria specified in the filter are

displayed in the IOA Log screen. For more information, see
Filtering the IOA Log Screen Display on page 383.

Chapter 2 Online Facilities 381

IOA Log Screen

Table 177 Commands of the IOA Log Screen (part 2 of 2)

Command Description
GROUP The GROUP Command alternately displays or hides the GROUP
name (if any) that is associated with the relevant job, mission or rule
definition. When displayed, the name of the group appears after the
job, mission or rule status.
CATEGORY The CATEGORY command alternately displays and hides the
CATEGORY of the relevant CONTROL-D mission. This command
applies to CONTROL-D generated messages only. When displayed,
the name of the category appears after the mission status.

Changing IOA Log Screen Display Types

While in the IOA Log screen, the display type can be changed through the DISPLAY
command. Format of the command is:

DISPLAY x

where x is a 1-character code that identifies the desired display type. DISPLAY can be
abbreviated DI.

For a list of display types, enter DISPLAY ? to show the Display Options window. To
select a display type in the window, type S in the Option field next to the ID. To exit
the window without selecting a display type, press the END key (PF03/PF15).

Example

DI B

displays the No Reverse display.

Valid predefined displays:

Table 178 IOA Log Screen Predefined Display Types

Display Description
A Show RBA (Relative Byte Address) display (displays the RBA of the
message within the IOA Log file in place of the ODATE)
D Default display
B No Reverse display (display is in No Reverse mode)

382 CONTROL-D and CONTROL-V User Guide

 IOA Log Screen

Uppercasing and lowercasing of variables values

While in the IOA Log Screen, uppercase or lowercase mode can be set using the CAPS
command. Format of the command is:

CAPS [{ON | OFF}]

In this command:

CAPS ON Forces all user entries to be saved and displayed in uppercase

characters, regardless of the case in which they were entered. Default.

CAPS OFF Enables certain user entries to be saved and displayed in lowercase
characters.

CAPS Indicates whether CAPS ON or CAPS OFF mode is active.

NOTE
Name of variables do not support lowercase characters.

Filtering the IOA Log Screen Display

Screen filters can be used to filter the IOA Log screen display.

A filter consists of a set of record selection criteria (selection fields and their values).
Only records that conform to the selection criteria specified in the filter are displayed
on the screen.

The INCONTROL administrator can predefine filters and place them in the General
profile.

Each user can activate an existing filter in the IOA Log screen by entering the SHOW
command in the COMMAND line of the IOA Log screen.

Each user can define multiple filters for the screen, through the IOA Log Show Screen
window, which is described in Fields of the IOA Log Show Screen Window on
page 386. User-defined filters belong to, are assigned names by, and can only be
activated by, the user who defined them. They are stored in the user profile.

You can see the list of all available filters by opening the Display Filters window.

A predefined default filter (DEFAULT) is defined for the IOA Log screen.
Site-defined defaults determine whether the last filter used or the DEFAULT filter is
activated upon reentry to the IOA Log screen.

Chapter 2 Online Facilities 383

IOA Log Screen

Activating an Existing Filter in the IOA Log Screen

The SHOW command can be used to activate an existing filter when you know the
name of the filter.

To activate an existing filter in the IOA Log screen, enter the SHOW command in
the COMMAND field, as follows:

SHOW name

where name is the name of the filter to be activated.

To activate the DEFAULT filter, use DEFAULT as the name of the filter.

Display Filters Window

When you do not know the name of a filter, you can still activate a filter from the list
of available filters by opening the Display Filters window. This window displays the
list of all available filters. These include Global filters that are available to all users, as
well as user-defined filters that are only available to the individual user. You can
activate a filter from the Display Filters window, or switch to the IOA Log Show
Screen window, where you can edit or define a filter.

To enter the Display Filters window, type SHOW ? in the COMMAND field of the
IOA Log screen and press Enter.

Figure 187 IOA Log Screen Display Filters Window

FILTER: DEFAULT ---------------- IOA LOG ------------------------(5)
COMMAND ===> SCROLL===> CRSR
SHOW LIMIT ON ==> DATE 080800 - 080800
DATE TIME ODATE USERID CODE ------------- M E S S A G E -------------
080800 092144 080800 M22 SPY254I JOB CT085955 CT085955/01835 SCANNED
080800 092144 080800 M22 SEL208I JOB CT085955 CT085955/01835 ENDED "OK"
0 +-----------------------------------+ B CT085956 CT085956/01836 SCANNED
0 | DISPLAY FILTERS | B CT085956 CT085956/01836 ENDED "OK"
0 | CMD ==> SCROLL==> CRSR | B BRIVPCC BRIVPCC /01843 SCANNED
0 | O NAME DESCRIPTION | B BRIVPCC BRIVPCC /01843 ENDED "OK"
0 | CONFIRM | EE OF TASK BRCC0001 ODATE 080800
| DEL | RFORMED
0 | END | B INTR0004 INTR0004/04371 START
| ENDNOTOK | 253.1316 STOP 98253.1316 CPU 0MIN
| ENDOK | .04SEC SRB 0MIN 00.00SEC 0.19
0 | EXEC | B INTR0004 INTR0004/04371 SCANNED
0 | LATE | B INTR0004 INTR0004/04371 ABENDED CC
| WAIT | 37 STEP STEP01
0 | ECSALL | B INTR0004 INTR0004/04371 ENDED "NOT
| =========>>> BOTTOM <<<========== | "
0 | | B BRCC0001 ELIGIBLE FOR RUN
0 | S-SELECT OPTION E-EDIT OPTION | B BRCC0001 BRCC0002/01958 SUBMITTED
0 +-----------------------------------+ B BRCC0002 ELIGIBLE FOR RUN
CMDS: SHOW, GROUP, CATEGORY, SHPF 09.43.00

384 CONTROL-D and CONTROL-V User Guide

 IOA Log Screen

Fields of Display Filters Window

The Display Filters window contains the following fields:

Table 179 Fields of the Display Filters Window

Field Description
NAME Name of the filter as it appears in the General or User profile.
DESCRIPTION Description of the filter.

Options of the Display Filters Window

To request one of the following options, type the option in the OPT field to the left of
the filter name and press Enter.

Table 180 Options of the Display Filters window

Option Description
S (SELECT) Filters which entries are displayed in the Automation Log Screen
according to the criteria specified in the selected filter.
E (EDIT) Opens the IOA Log Show Screen window, where the filter criteria
are displayed. You can modify the filter criteria.

IOA Log Show Screen Window

The IOA Log Show Screen window in the IOA Log screen enables you to create or
modify a filter.

To open an existing filter for editing, enter the following command:

SHOW filtername EDIT

where filtername is the name of the filter to be displayed in the IOA Log Show
Screen window.

To edit the currently active filter, it is not necessary to enter the name of the filter or
the EDIT keyword. Enter the SHOW command in the COMMAND field, or press
PF02/PF14. The following IOA Log Show Screen window is displayed:

Chapter 2 Online Facilities 385

IOA Log Screen

Figure 188 IOA Log Show Screen Window

FILTER: DEFA +-------------------- IOA LOG SHOW SCREEN -------------------(5)
COMMAND ===> | FILTER SAVE (Y/N) Desc: |
SHOW LIMIT O | |
DATE TIME | |
080800 14131 | |
| |
| CD+CV : SBSYS REP MIS SHOUT USER GENERAL DAILY MONIT STAT |
080800 14131 | Y Y Y Y Y Y N N N |
080800 14131 | |
080800 14153 | |
| |
080800 14155 | |
| CODE |
| URGENCY: REGULAR Y URGENT Y VERY-URGENT Y |
080800 14155 | TASK TYPE |
080800 14155 | |
080800 14173 | CD: REP PRT BKP/MIG RST EMR NOEMR CYC NOCYC |
| Y Y Y Y Y Y Y Y |
080800 14174 | USERID N54A |
| MEM/MIS MIGDASD |
| JOBNAME |
080800 14174 | CATEGORY |
080800 14174 | GROUP |
080800 14174 | ORDERID |
CMDS: SHOW, +--------------------------------------------------------------+

To create a new filter, open any existing filter and enter a new name and
description in the FILTER and DESC fields (described in Fields of the IOA Log
Show Screen Window, below).

Fields of the IOA Log Show Screen Window

The IOA Log Show Screen window contains the following fields:

Table 181 Fields of the IOA Log Show Screen Window

Field Description
FILTER User-assigned name of the filter. The name entered in the FILTER
field can be modified.

If changes to a filter have not been saved, an asterisk is displayed to

the right of the filter name. For more information, see Closing the
IOA Log Show Screen Window on page 389.
SAVE (Y/N) Specifies whether to save modifications to the filter upon closing the
window.
Desc: User-defined description of the filter. The description entered here
appears next to the name in the Displaying Filters window.

386 CONTROL-D and CONTROL-V User Guide

 IOA Log Screen

NOTE
The INCONTROL administrator can limit which installed INCONTROL products and
options each user may access. However, because all INCONTROL products and the messages
they issue are integrated, it may be important for users to see the messages of products and
options to which they have no access. Therefore, the types of messages for all INCONTROL
products are listed in the IOA Log Show Screen window, and by default, the messages of all
installed products are listed in the IOA Log screen.

Fields that define the selection criteria to be applied to the screen are described below.
Fill in the selection criteria as necessary.

NOTE
The selection criteria marked with the P symbol act on a prefix basis. For example, typing D4
in the USERID field causes the retrieval of all User IDs whose names start with D4.

Table 182 IOA Log Show Screen Window Selection Criteria (part 1 of 2)
Criteria Description
CV message type To limit the type of log messages displayed, enter Y (Yes) or N (No)
under the desired message type. Valid CONTROL-V message type
codes:

SBSYS Messages generated during New Day processing.

REP Report decollating mission-related messages.

MIS Printing, backup and restore mission-related messages.

SHOUT Messages written to the IOA Log file by parameter

SHOUT. For more information see parameter SHOUT on
page 599.

USER Messages resulting from manual intervention of

authorized users in the operation of CONTROL-V; for example,
the addition of a prerequisite condition.

GENERAL General messages on CONTROL-V operation.

DAILY Internal messages generated during New Day

processing. For use mainly by maintenance personnel.

MONIT Internal messages of the monitor. For use mainly by

maintenance personnel.

STAT Statistical information about mission execution.

Note: Selection criteria identified by CV message type are specific to CONTROL-V. Other
selection criteria, such as those described below, are primarily applicable to other
INCONTROL products, but may also be available to CONTROL-V.

Chapter 2 Online Facilities 387

IOA Log Screen

Table 182 IOA Log Show Screen Window Selection Criteria (part 2 of 2)
Criteria Description
P
CODE Show only IOA Log file messages with the specified message IDs or
prefix(es). A maximum of 6 message IDs (or prefixes) can be
specified.
URGENCY Mark Y (Yes) or N (No) to specify the desired urgency of messages.
Urgent and very urgent messages are highlighted.
TASK TYPE When mission messages are selected, limit the task types to be
displayed. Enter Y to include or N to exclude the following task
types:

REP Report decollating mission

PRT Printing mission
BKP Backup mission
RST Restore mission
EMR Emergency mission
NOEMR Non-emergency mission
CYC Cyclic mission
NOCYC Non-cyclic mission
P
USERID Show only messages of the specified user IDs. A maximum of five
user IDs can be specified.
Note: Selection criteria MEM/MIS, JOBNAME, CATEGORY, and GROUP (described below)
only affect the display of messages related to a mission. Messages not related to a mission are
not affected by these selection criteria and are displayed unless suppressed by other
selection criteria.
MEM/MISP Limit displayed messages to the specified member and mission
names. A maximum of five member or mission names can be
specified. Messages not related to a mission are not affected by this
show limit.
JOBNAMEP Limit displayed messages to the specified job names. A maximum of
five job names can be specified. Messages not related to a job are not
affected by this show limit.
CATEGORYP Limit displayed messages to the specified categories. A maximum of
two categories can be specified. Messages not related to a mission are
not affected by this show limit.
ORDERID Limit displayed job messages to the specified order ID

IOA Log Show Screen Window (at Sites Where Multiple

INCONTROL Products Are Active)
The IOA Log Show Screen window displays different selection criteria depending on
which INCONTROL products are operational at your site.

The IOA Log Show Screen window at sites where all INCONTROL mainframe
products are active is illustrated below.

388 CONTROL-D and CONTROL-V User Guide

 IOA Log Screen

Figure 189 IOA Log Show Screen Window at Sites where Multiple
INCONTROL Products are Active
FILTER: +-------------------- IOA LOG SHOW SCREEN -------------------(5)
COMMAND ===> | FILTER SAVE (Y/N) Desc: |
SHOW LIMIT O | CM : D JOB M JOB SHOUT USER GENERAL D INT M INT STAT |
DATE TIME | Y Y Y Y Y N N N |
080800 06290 | CO+CMEM: GENERAL SHOUT JOBS GENERAL W PIPE W JOB W |
| Y Y Y |
080800 06290 | CD+CV : SBSYS REP MIS SHOUT USER GENERAL DAILY MONIT STAT |
080800 06290 | Y Y Y Y Y Y N N N |
080800 06290 | CB : RUNTIME SHOUT DAILY GENERAL STATISTICS |
| Y Y Y Y Y |
080800 06521 | CT : GENERAL SHOUT REAL-TIME UTILITIES |
080800 06521 | Y Y Y Y |
080800 06521 | CODE |
| URGENCY: REGULAR Y URGENT Y VERY-URGENT Y |
080800 07290 | TASK TYPE CM: JOB CYC EMR STC CST EST ECJ ECS WRN GRP |
080800 07290 | Y Y Y Y Y Y Y Y Y Y |
080800 07290 | CD: REP PRT BKP/MIG RST EMR NOEMR CYC NOCYC |
| Y Y Y Y Y Y Y Y |
080800 07290 | USERID N54A |
080800 07290 | MEM/MIS MIGDASD |
080800 07290 | JOBNAME |
| CATEGORY |
080800 07493 | GROUP |
080800 07493 | ORDERID |
CMDS: SHOW, +--------------------------------------------------------------+

The CONTROL-V selection criteria are described in Table 182. For descriptions of the
selection options for other INCONTROL products, see the user guides of the
respective products.

NOTE
The INCONTROL administrator can limit which installed INCONTROL products and
options each user can access. However, because all INCONTROL products and the messages
they issue are integrated, it may be important for users to see the messages of products and
options to which they have no access. Therefore, the types of messages for all INCONTROL
products are listed in the IOA Log Show Screen window, and by default, the messages of all
installed products are listed in the IOA Log screen.

Closing the IOA Log Show Screen Window

You can activate an edited filter with or without saving changes, depending on the
value you type in the SAVE field, as follows:

To activate and save the filter, type Y (Yes) in the SAVE field. Changes to the filter
are permanently saved.

To activate the filter without saving it, type N (No) in the SAVE field. Changes are
kept in memory only, but are not saved.

After entering a value in the SAVE field, press one of the following keys:

Chapter 2 Online Facilities 389

IOA Calendar Facility

Table 183 IOA Log Show Screen Window - Closing Values

PFKey Description
Enter Filtering begins with the first message currently displayed in the
screen and continues downward.
PF07 (UP) Filtering begins with the first message in the IOA Log file and
continues downward.
PF08 (DOWN) Filtering begins with the last message in the IOA Log file and
continues upward.

The window is closed and the filter is activated as defined or modified.

To cancel changes made in the IOA Log Show Screen window, press RESET
(PF10/PF22). The changes are canceled regardless of the value specified in the SAVE
field, the window is closed, and the filter that was previously in effect is restored.

By default, pressing END (PF03/PF15) in the window works like pressing Enter.
However, the default can be modified so that pressing END works like pressing
RESET.

IOA Calendar Facility

The IOA Calendar facility enables you to create, view, or modify calendar definitions.

Calendars simplify the scheduling of INCONTROL product jobs, missions, rules, and
so on. When a particular schedule is used in many job scheduling, mission, and/or
rule definitions, a calendar can be defined for that schedule, and the name of that
calendar can be specified in all the job, mission, or rule definitions that use that
particular schedule.

For example, calendars may be defined to handle the normal scheduling needs for
workdays, holidays, weekends, beginning of month, end of month, and so on.
Exception calendars may also be created.

A calendar definition consists of parameters that specify when scheduling occurs.

Calendar definitions are stored in members. A member usually contains multiple

calendar definitions, as follows:

A member contains the calendars required for a specific type of scheduling need.
For example, the calendar member WORKDAYS may contain the calendar
definitions for normal workday scheduling.

390 CONTROL-D and CONTROL-V User Guide

 Accessing the IOA Calendar Facility

Each calendar definition in that member defines the schedule for a given year. For
example, the calendar member WORKDAYS may contain calendar definitions
2001, 2002, and 2003. Each of those definitions contains the normal workday
schedule for the corresponding year.

The IOA Calendar facility also enables the definition of varied work periods
throughout the year, in special calendars called periodic calendars.

A calendar definition needs to be created only once. Once defined, the definition is
saved and used as necessary for scheduling. Calendar definitions can be modified or
deleted as required.

Any number of calendar members can be defined. Calendar members are stored in
calendar libraries (partitioned datasets). Generally one calendar library is defined at
time of installation, and referenced by DD statement DACAL.

NOTE
The IOA Calendar facility does not support members that have been compressed using the
ISPF PACK option.

Accessing the IOA Calendar Facility

The IOA Calendar facility contains the following screens:

Table 184 IOA Calendar Facility Screens

Screen Description
IOA Calendar Facility Enables specification of parameters that determine which records are
entry panel displayed in subsequent screens.
Calendar List screen Displays the list of calendar members in the specified calendar
library.
Year List screen Displays the list of years for which there is a calendar definition in
the selected calendar member.
Calendar Definition Displays the parameters of the selected calendar for the selected
screen year. This is the main screen of the facility.

To enter the IOA Calendar facility, select option 8 in the IOA Primary Option menu.
The IOA Calendar facility entry panel is displayed.

Depending on the values specified in the entry panel, you can bypass the Calendar
List screen and/or the Year List screen.

Chapter 2 Online Facilities 391

Entry Panel

Entry Panel
The entry panel is displayed upon entering the IOA Calendar facility (option 8 in the
IOA Primary Option menu).

Figure 190 IOA Calendar Facility Entry Panel

--------------------- IOA CALENDAR FACILITY - ENTRY PANEL ------------------(8)
COMMAND ===>

SPECIFY LIBRARY, CALENDAR, YEAR

LIBRARY ===> IOA.PROD.CAL

CALENDAR ===> (Blank for calendar selection list)
YEAR ===> (Blank for year selection list)

USE THE COMMAND "SHPF" TO SEE PFK ASSIGNMENT 10.58.42

Fields of the Entry Panel

Fill in the following fields and press Enter.

Table 185 Fields of the IOA Calendar Facility Entry Panel (part 1 of 2)
Field Description
LIBRARY Name of the desired calendar library. Mandatory.

If you make an entry in this field without filling in the

CALENDAR field, the list of calendars in the selected library is
displayed in the Calendar List screen.

If you make an entry in this field, you can restrict the list of
calendars that are displayed by entering in the CALENDAR field
part of a Calendar name together with a mask character or
characters (? and *).

392 CONTROL-D and CONTROL-V User Guide

 Calendar List Screen

Table 185 Fields of the IOA Calendar Facility Entry Panel (part 2 of 2)
Field Description
CALENDAR Name of the desired calendar member. Optional.

If an entry is made in this field without filling in the YEAR field, the list
of years in the selected calendar member is displayed in the Year List
screen.
YEAR Year of the desired calendar definition. Optional.

This field can be used only if a CALENDAR value is also entered. If

specified, the calendar definition is displayed in the Calendar Definition
screen.

NOTE
If you use the selection list fields, their values are not erased until you exit the entry panel by
pressing END (PF03/PF15).

Calendar List Screen

The Calendar List screen displays a list of calendars (members) in the specified
library. This screen can be entered directly from the entry panel or upon exiting the
Year List screen.

By default, only calendar names are listed in the screen. However, if the default has
been modified at time of installation, statistical information is displayed for each
calendar name, as shown in Figure 191.

Figure 191 Calendar List Screen

CALENDARS IN LIB IOA.PROD.CAL ------------(8.D)
COMMAND ===> SCROLL===> CRSR
OPT NAME ------------ VV.MM CREATED CHANGED SIZE INIT MOD ID
BANKDAYS 01.00 02/01/28 01/06/29 09:50 104 104 0 IOAPROD
DAYSOFF 01.00 02/01/28 01/06/29 09:50 30 30 0 IOAPROD
HOLIDAYS 01.00 02/01/28 01/06/29 09:50 15 15 0 IOAPROD
PERIOD1O 01.00 02/01/28 01/06/29 09:50 45 45 0 IOAPROD
SACAYCLN 01.01 02/01/28 01/11/29 17:43 26 26 0 L3051
SPMONCLN 01.01 02/01/29 01/11/30 15:00 117 104 0 M16A
SPWEKCLN 01.01 02/01/29 01/11/30 15:10 117 104 0 M16A
STOCKDAY 01.00 02/01/30 01/06/31 09:50 45 45 0 IOAPROD
WORKDAYS 01.01 02/01/30 01/11/31 17:43 26 26 0 L3051
======= >>>>>>>>>>>>>>>> NO MORE CALENDARS IN LIBRARY <<<<<<<<<<<<<<<< ======

Chapter 2 Online Facilities 393

Year List Screen

OPTIONS: S SELECT B BROWSE D DELETE 13.54.14

To return to the entry panel, press END (PF03/PF15).

Options of the Calendar List Screen

To request one of the following options, type the option in the OPT field to the left of
the calendar names, and press Enter.

Table 186 Options of the Calendar List Screen

Option Description
S (SELECT) Display the list of years for the calendar for any purpose, including
editing or modification. Only one calendar can be selected at a time.
B (BROWSE) Display the list of years for the calendar for browsing. Only one
calendar can be selected at a time.
D (DELETE) Delete the calendar (member) from the library. Multiple calendars
can be selected.

Year List Screen

The screen displays the list of years for which a specified calendar is defined. This
screen can be entered directly through the entry panel or the Calendar List screen, or
upon returning from the Year Definition screen.

NOTE
If the S (Select) option was entered in the Calendar List screen for a calendar that is currently
in use (selected) by another user, either the Year List screen is not displayed and the Calendar
List screen remains displayed (the default), or the Year list screen is displayed in Browse
mode (if a user profile definition overrides the default). In either case, an appropriate message
is displayed.

If a calendar description was defined in the Calendar Definition screen, the definition
is displayed to the right of the year.

394 CONTROL-D and CONTROL-V User Guide

 Year List Screen

Figure 192 Year List Screen

LIST OF YEARS IN IOA.PROD.CAL CALENDAR WORKDAYS
COMMAND ===> SCROLL===> CRSR
OPT YEAR ------------------ DESCRIPTION --------------------------------------
2001 REGULAR WORKING DAYS IN 2001
2002 REGULAR WORKING DAYS IN 2002
2003 REGULAR WORKING DAYS IN 2003
2004 REGULAR WORKING DAYS IN 2004
2005 REGULAR WORKING DAYS IN 2005
======= >>>>>>>>>>>>>>>> NO MORE YEARS IN CALENDAR <<<<<<<<<<<<<<<< =====

OPTIONS: S SELECT D DELETE I INSERT W INSERT BY WEEK DAYS C COPY 08.52.54U

To return to the Calendar List screen press END (PF03/PF15).

Format of the Year List Screen

Next to each year in the Year list, certain information can be displayed. The type and
format of this information depends on whether the screen is displayed in DESC
format or in STAT format:

In DESC format, the description of the year, taken from the DESC field of the
calendar definition, is displayed. Default.

In STAT format, the ISPF statistical information for the calendar definition is
displayed.

By default, the Year list is displayed in DESC format. To change formats, use the
DESC or STAT commands, described in Table 187.

Commands of the Year List Screen

The following commands can be entered in the COMMAND field of the Year List
screen.

Chapter 2 Online Facilities 395

Year List Screen

Table 187 Commands of the Year list screen

Command Description
DESC The DESC command displays the calendar description next to the
year. The description is taken from the DESCRIPTION field in the
calendar definition.
STAT The STAT command displays the following ISPF-like statistical
information about the calendar next to the year: version and
modification numbers, creation date, last modification date, and user
ID.

Options of the Year List Screen

To request one of the following options, type the option in the OPT field to the left of
the year and press Enter.

NOTE
If the Year List screen is displayed in Browse mode, options D (Delete), I (Insert), and W
(Insert By Week Days) are not available.

Table 188 Options of the Year List Screen

Option Description
S (SELECT) Display the calendar definition for the specific year.

Parameters can be edited and updated only if the Calendar

Definition screen is not displayed in Browse mode. If the Calendar
Definition screen is displayed in Browse mode, the screen can only
be browsed and parameters cannot be modified.
D (DELETE) Delete the calendar definition for the specified year.
I (INSERT) Insert a new year in the Year List screen and display the Calendar
Definition screen with a predefined year definition for editing. The
predefined calendar definition is defined with the same dates as the
year next to which the I (Insert) request was specified. For more
information, see Inserting a New Year.
W (INSERT BY WEEK Insert a new year in the Year List screen and display the Calendar
DAYS) Definition screen for editing a predefined year definition. The
predefined year definition is defined with the same days of the week
as the year next to which the W (Insert by Week Days) request was
specified. For more information, see Inserting a New Year.
C (COPY) Copy the year to another calendar, as described in Copying Years to
Another Calendar on page 398. Multiple years can be selected.

396 CONTROL-D and CONTROL-V User Guide

 Year List Screen

Inserting a New Year

All calendar definitions identified in the same Year List usually have the same fixed
scheduling pattern. Often, this scheduling pattern is based either on dates within a
month or on days of the week within the month. For example:

Calendar QUARTERLY might always indicate scheduling for the last day of
March, June, September and December (that is, a scheduling pattern based on
dates).

Calendar WEEKEND might always indicate scheduling all Saturdays and/or

Sundays in each month (that is, a scheduling pattern based on days of the week).

This scheduling pattern also applies to new calendar definitions resulting from the
insertion of a new year in the Year List screen.

When a year is inserted in the Year List, the IOA Calendar facility automatically
generates a predefined calendar definition for the new year, based on the scheduling
pattern of the calendar by which the insert request was specified. This frees the user
from having to manually define the new calendar. This automatically generated
calendar definition can be displayed and modified.

NOTE
The Year list must be kept in ascending order without missing years (for example, 2001, 2002,
2003, 2004, 2005). Each new year must be added at the end of the list.

In calendar definitions, a defined scheduling date is described by both the date

(month and day) and the day of the week. Because a particular date falls on a
different day of the week in different years, it is necessary to indicate whether the
scheduling pattern is based on the date or on the days of the week. This is
indicated by the specified insert option.

To define the calendar with the same scheduling dates (although corresponding
days of the week may vary, for example, calendar QUARTERLY described above),
type option I (INSERT).

To define the calendar so that scheduling takes place on the same weekdays as in
the previous calendar (although the corresponding dates may vary, for example,
calendar WEEKEND described above), type option W (INSERT BY WEEK DAYS).

If the scheduling pattern is mixed (for example, calendar HOLIDAYS always

indicates scheduling on both January 1 and the first Monday in September),
specify the more appropriate option and correct the new calendar definition
manually.

Chapter 2 Online Facilities 397

Copying Years to Another Calendar

Copying Years to Another Calendar

Years currently displayed in the Year List screen can be copied to another calendar.
To copy the desired years, type option C (COPY) next to each desired year in the
screen and press Enter. The following window is displayed:

Figure 193 Calendar List Screen Copy Window

LIST OF YEARS IN: IOA.PROD.CAL CALENDAR: CALEN1
COMMAND ===> SCROLL===> CRSR
OPT YEAR -------- DESCRIPTION ------------------------------------------------
2001 REGULAR WORKING DAYS IN 2001
C 2002 REGULAR WORKING DAYS IN 2002
2003 REGULAR WORKING DAYS IN 2003
2004 REGULAR WORKING DAYS IN 2004
+-----------------------------------------------------------+
| |
| SPECIFY DESTINATION LIBRARY,CALENDAR AND RULE NAME |
| |
| LIBRARY : IOA.PROD.CAL |
| CALENDAR: |
| YEAR : 2005 |
| |
| PRESS END/RESET TO CANCEL ENTER TO PERFORM THE COPY |
+-----------------------------------------------------------+

OPTIONS: S SELECT D DELETE I INSERT W INSERT BY WEEK DAYS C COPY 15.37.39

The window contains the following fields (some fields contain default values that can
be modified):

Table 189 Fields of the Calendar List Screen Copy Window

Field Description
LIBRARY Library containing the calendar into which the years must be copied.
Must be an existing library. Default: The current library.
CALENDAR Name of the calendar into which the year must be copied.
Note: A year can only be copied to another calendar. It cannot be copied
to its own calendar (even if the year is renamed).

If the selected calendar does not exist in the Calendar List, the calendar is
created when the request is performed.
YEAR Name of the year to be copied. If multiple years are selected, the window
is initially displayed with the first selected year. As each request is
performed or canceled, the next requested year name appears.

To perform a request, press Enter.

398 CONTROL-D and CONTROL-V User Guide

 Calendar Definition Screen

To cancel a request, press END (PF03/PF15) or RESET (PF04/PF16).

Calendar Definition Screen

This screen is used to define, display and modify dates in a calendar for a specific
year. This screen can be entered directly from the entry panel or from the Year List
screen.

Figure 194 Calendar Definition Screen

--------------------------- IOA CALENDAR - WEEKDAYS ----------------------(8.Y)
COMMAND ===> SCROLL===> CRSR
YEAR 2002 REGULAR WORKDAYS IN 2002

-----S-------------S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
01 Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y
-----S-------------S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8
02 Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y
-----S-------------S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
03 Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y
-----S-------------S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 +
04 Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y
-----S-------------S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
05 Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y
-----S-------------S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 +
06 Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y
-----S-------------S-------------S-------------S-------------S-------------S---
TYPE Y IN ALL THE EXECUTION DAYS 14.37.10

Fields of the Calendar Definition Screen

Table 190 Fields of the Calendar Definition Screen (part 1 of 2)

Field Description
YEAR Year of the calendar. This value can be modified. When modified, the
values indicated for each date in each month (described below) are
shifted to the appropriate day of the week.

Chapter 2 Online Facilities 399

Calendar Definition Screen

Table 190 Fields of the Calendar Definition Screen (part 2 of 2)

Field Description
description User-supplied, free text description of the calendar. Optional.
month/dates Each month of the year (01 12) of the calendar consists of the
following:

Separator line. Sunday (or Saturday) is marked S (according to

the site-specified default).
Month label (01 to 12).
Date label for the updatable day of the month.
Updatable field for defining execution dates. Valid values:
Y Select the job on that date.
N (No) or ' ' (Blank) Do not select the job for execution on that
date.
+ For a relative calendar, select the closest next date.
- For a relative calendar,a select the closest previous date.
a
A relative calendar is a calendar used in a formula to create other calendars. It cannot be
specified in a DCAL/WCAL/CONFCAL field. For details, see utility IOABLCAL in the
INCONTROL for z/OS Utilities Guide.

Periodic Calendars
Some jobs must be scheduled periodically, according to schedules that are not easily
expressed in terms of fixed days and dates within months. In these cases, monthly, or
even yearly, scheduling definition is awkward. For example:

A payroll job needs to be scheduled every other Wednesday:

In some months, the job may be scheduled on the first, third, and even fifth
Wednesday in the month. In other months, it may be scheduled on the second
and fourth Wednesday in the month.

In some years, the job may be scheduled beginning on the first Wednesday of
the year. In other years, it may be scheduled beginning on the second
Wednesday of the year.

A job must be scheduled every 25 days, regardless of date. Such a job is scheduled
on different dates each month and each year.

The IOA Calendar facility provides special calendars, called periodic calendars, to
allow specification of these scheduling requirements. These periodic calendars are
very flexible.

To designate a calendar as periodic, you must type reserved string ==PERIODIC== in

the first 12 positions of the description field. Any text can be entered in the rest of the
description field. This is illustrated in the following figure.

400 CONTROL-D and CONTROL-V User Guide

 Calendar Definition Screen

Figure 195 Use of Reserved String ==PERIODIC==

COMMAND ===> SCROLL===> CRSR
YEAR 2002 - ==PERIODIC== GENERAL WORKDAY CALENDAR

The following are characteristics of periodic calendars:

In a periodic calendar, days are not marked using the letters Y (Yes) or N (No).
Instead, a period identifier is used to mark working days in a period. A period
identifier can be any letter from A to Z (except Y and N), any number from 0 to 9,
or any other printable sign. If you need more characters, use characters falling
within the hexadecimal range 4A through F9. All working days within the same
period must be marked using the same period identifier character so that different
identifier characters indicate different periods. Days that are not marked are
nonworking days because they do not belong to any period in this calendar.

Identifiers from different periods can be interspersed throughout a periodic

calendar.

A periodic calendar can consist of smaller units that do not correspond to regular
months, in that they can be longer or shorter than regular months.

A periodic calendar can span a period, called a logical year, which can be longer
or shorter than one regular calendar year.

When a periodic calendar spans parts of two regular calendar years, special
considerations are likely to arise. For more information, see Special Year-End
Handling of Periodic Calendars on page 402.

A period can span any number of days, but no more than a preset number of days
can elapse after the appearance of one identifier in a period until the appearance of
the next matching identifier in the same period. After that period expires, the next
matching identifier starts a new period.

By default, this period is preset to 33 days. Once the length of the gap between
matching identifiers exceeds 33 days, the period automatically closes.

NOTE
The length of the default period can be changed from 33 days by the INCONTROL
administrator, using optional Wish WM2888.

For more information on the use of periodic calendars, see DAYS: Basic Scheduling
Parameter on page 438 and WDAYS: Basic Scheduling Parameter on page 610.

Examples

The following are examples of periodic calendars:

Chapter 2 Online Facilities 401

Calendar Definition Screen

Figure 196 Periodic Calendar Example 1

-----S-------------S-------------S-------------S-------------S-------------S--
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
12 A A A B A
-----S-------------S-------------S-------------S-------------S-------------S--
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
01 B B
-----S-------------S-------------S-------------S-------------S-------------S--

This example contains two periods: A and B.

Period A starts on December 13 and ends on December 23. During this period, the
defined working days are December 13, December 18, December 20, and December
23.

Period B spans more than one calendar year. It starts on December 21 and ends on
January 24. During this period, the defined working days are December 21,
January 4, and January 24.

Figure 197 Periodic Calendar Example 2

-----S-------------S-------------S-------------S-------------S-------------S----
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
03 B A B A
-----S-------------S-------------S----------0---S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 +
04 B
-----S-------------S-------------S-------------S-------------S-------------S--

This example includes a period B that begins on March 9. The last marked working
day of the period is March 21, which is followed by a 33-day gap. Assuming that
Wish WM2888 has not been used to alter the default period of 33 days, period B
automatically ends on April 23, and April 24 marks the beginning of a new period B.
If no more B identifiers are added, this new B period ends on May 27.

Special Year-End Handling of Periodic Calendars

Jobs or missions may be improperly scheduled if a periodic calendar contains one or
more periods that start in one year and continue into the next year, under the
following circumstances:

If the default gap between occurrences of matching identifiers has been changed
from 33 days to a longer period

and

If the first occurrence of the matching identifier in one logical year falls within the
default gap that began at the last occurrence of the matching identifier in a prior
logical year

402 CONTROL-D and CONTROL-V User Guide

 Calendar Definition Screen

In such cases, the period in the prior logical year overlaps the period in the later
logical year, causing a scheduled rule not to run in the later logical year as expected.

To avoid this problem, remove logical years from periodic calendars as soon as they
are no longer needed.

Example

Logical year FISCAL01 extends from April 1, 2001 through March 31, 2002.

Logical year FISCAL01 contains a period identified as Period A that has been
defined to begin on December 28, 2001 and to continue through January 15, 2002.

Logical year FISCAL02 extends from April 1, 2002 through March 31, 2003.

Logical year FISCAL02 also contains a period identified as Period A, defined to

begin on April 20, 2002 and continue through May 3, 2002.

Job X is scheduled for the seventh day of Period A in each logical year, through the
rule definition DAYS=D7PA.

In a case where the default gap being 33 days, Rule X runs in January 2002, and again
in April 2002, as expected.

In a case where the default gap is changed from 33 to a longer period, such as 120
days, the first day of Period A in logical year FISCAL02 occurs less than 120 days after
the last appearance of Period A in logical year FISCAL01. As a result, what appears to
be the seventh day in Period A in April 2002 is not recognized as such, because the
old Period A overlaps the new Period A. Consequently, Rule X does not run
again when the user may have expected it to run.

Deleting Calendars
To delete calendars, type option D next to the calendar names in the Calendar List
screen and press Enter.

The following confirmation window is displayed, in sequence, for each calendar

selected for deletion.

Chapter 2 Online Facilities 403

Exiting the IOA Calendar Facility

Figure 198 Calendar List Screen Delete Confirmation Window

CALENDARS IN LIB IOA.PROD.CAL ------------(8.D)
COMMAND ===> +--------------------------+ SCROLL===> CRSR
OPT NAME --- | CONFIRM DELETE OPTION | E INIT MOD ID
D BANKDAYS <-----------| (Y/N) | 4 104 0 IOAPROD
DAYSOFF +--------------------------+ 0 30 0 IOAPROD
HOLIDAYS 01.00 02/01/28 01/06/29 09:50 15 15 0 IOAPROD
PERIOD1O 01.00 02/01/28 01/06/29 09:50 45 45 0 IOAPROD
D SACAYCLN 01.01 02/01/28 01/11/29 17:43 26 26 0 L3051
SPMONCLN 01.01 02/01/29 01/11/30 15:00 117 104 0 M16A
SPWEKCLN 01.01 02/01/29 01/11/30 15:10 117 104 0 M16A
STOCKDAY 01.00 02/01/30 01/06/31 09:50 45 45 0 IOAPROD
WORKDAYS 01.01 02/01/30 01/11/31 17:43 26 26 0 L3051
======= >>>>>>>>>>>>>>>> NO MORE CALENDARS IN LIBRARY <<<<<<<<<<<<<<<< ======

OPTIONS: S SELECT D DELETE I INSERT W INSERT BY WEEK DAYS C COPY 13.54.14

Type Y (Yes) in the window to delete the calendar.

Type N (No) in the window to cancel the delete request.

NOTE
If PDSMAN is operational at your site, $$$SPACE members are not deleted.

For each calendar deleted, a message is written to the IOA Log file.

Exiting the IOA Calendar Facility

When exiting the IOA Calendar facility, screens are exited in the following sequence:

1. Calendar Definition screen

2. Year List screen

3. Calendar List screen

404 CONTROL-D and CONTROL-V User Guide

 Exiting the IOA Calendar Facility

NOTE
If the Calendar List screen was bypassed as you entered the IOA Calendar facility (that is, if
you entered a CALENDAR value in the entry panel), the Calendar List screen is not displayed
upon exiting the Year List screen; instead, the entry panel is displayed.

Calendar Facility Entry Panel

The commands and options available when exiting screens depend on the screen
being exited and on whether changes have been made. If changes have been made,
the selected exit options and commands determine whether the changes are saved.
Exit options and commands are discussed below on a screen by screen basis.

Exiting the Calendar Definition Screen

Use any of the following commands, or press the corresponding PFKey, to exit the
Calendar Definition screen:

Table 191 Commands for Exiting the Calendar Definition Screen

Command Description
CANCEL Cancel the changes made to the calendar definition and return to the
Year List screen.
Note: The following exit commands retain changes to the calendar definition in memory. To
permanently save the changes to disk, you must also request that the changes be saved when
you exit the Year List screen.
END (PF03/PF15) Keep changes to the calendar definition in memory and exit to the
Enter Year List screen.
NEXTYEAR Keep changes to the calendar definition in memory and display the
(PF11/PF23) next calendar definition in the Year List screen.
PREVYEAR Keep changes to the calendar definition in memory and display the
(PF10/PF22) previous calendar definition in the Year List screen.

Exiting the Year List Screen

Press END (PF03/PF15) to exit the Year List screen. If changes made to at least one
calendar definition have been kept in memory or if any changes have been made to
the Year List screen, the Exit Option window is displayed. For more information, see
Exiting the Calendar Definition Screen on page 405.

Chapter 2 Online Facilities 405

Exiting the IOA Calendar Facility

Figure 199 Year List Screen Exit Option Window

LIST OF YEARS IN IOA.PROD.CAL CALENDAR WORKDAYS
COMMAN +-----------------------------------------------------------+ ===> CRSR
OPT N | PLEASE SELECT EXIT OPTION |
1 | |
1 | SAVE CREATE |
1 | |
====== | LIBRARY IOA.PROD.CAL | << =====
| TABLE WORKDAYS |
| |
+-----------------------------------------------------------+

OPTIONS: S SELECT D DELETE I INSERT W INSERT BY WEEK DAYS C COPY 08.53.50

Fill in the Exit Option window as follows:

The LIBRARY and TABLE (member) fields indicate the library and member in which
the calendar definitions must be saved. The specified values can be modified (for
example, to save the calendar definitions in a different member).

To save all changes currently in memory and exit the Year List screen, type Y (Yes)
after the word SAVE or CREATE:

Type Y after the word SAVE if a member with the same calendar name already
exists in the specified library.

Type Y after the word CREATE if a member with the same calendar name does
not exist in the specified library.

NOTE
If you create a new calendar member, the member name does not appear in the Calendar
List screen upon exiting the Year List screen; it first appears when you reenter the Calendar
List screen from the entry panel.

To cancel changes currently in memory and exit the Year List screen, type N (No)
after the word SAVE or CREATE.

To close the Exit Option window and remain in the Year List screen (with the
changes remaining in memory), press RESET (PF04/PF16).

406 CONTROL-D and CONTROL-V User Guide

 Utilities Under ISPF

Exiting the Calendar List Screen

Press END (PF03/PF15) to exit the Calendar List screen.

Exiting the Entry Panel

Press END (PF03/PF15) to exit the entry panel.

Utilities Under ISPF

Several IOA facilities can only be activated under ISPF. To activate these facilities,
select option 6 on the IOA Primary Option menu (under ISPF) or invoke the IOAUTIL
CLIST from the TSO Command Processor. The IOA Online Utilities menu is
displayed.

NOTE
The INCONTROL administrator can remove user authority to access option 6 on the IOA
Primary Option menu. In this case, the IOA Online Utilities menu is not displayed.

IOA Online Utilities Menu

Depending on the INCONTROL products that are available at your site, different
online utility options are displayed in the Online Utilities menu. Figure 200 shows the
IOA On-line Utilities menu that is displayed when all applicable INCONTROL
products are active.

Chapter 2 Online Facilities 407

D1: Schedule a Report Decollating Mission

Figure 200 IOA Online Utilities Menu when all INCONTROL Products are Installed
------------------------------ ON-LINE UTILITIES ------------------------------
USERID - N06
TIME - 13:40
TERMINAL - 3278

D1 DECOLLATING - Schedule a Report Decollating Mission

D2 PRINT - Schedule a Printing Mission
D3 BACKUP/MIGRATION - Schedule a Backup/Migration Mission
D4 RESTORE - Schedule a Restore Mission
I1 PREREQ CONDITION - Add/Check/Delete a Prerequisite Condition
M1 JOB ORDER ISSUE - Issue a Job Order
M2 AUTOEDIT SIMUL - Perform an AutoEdit Simulation
M3 SIMUL/TAPE PULL - Prepare Simulation/Tape Pull List Job
M4 PARAM PROMPTING - Parameter Prompting Facilities
M5 QUICK SCHEDULE - Quick Schedule Definition
M6 USER INTERFACE - End-User Job Order Interface
R1 CTM/RESTART SIM - CONTROL-M/Restart Simulation
R2 DATASET CLEANUP - CONTROL-M/Restart Dataset Cleanup
R3 JOB DATASET LIST - Prepare a Job Dataset List
R4 STANDALONE - CONTROL-M/Restart Standalone
T1 CONTROL-M/Tape SIMUL - Simulate CONTROL-M/Tape Rules
X EXIT - Exit This Menu

OPTION ===>

NOTE
If DOCU/TEXT has also been installed at your site, an additional utility, option U1, is
displayed in the Online Utilities menu.

To access an available utility, type the desired option number in the OPTION field
and press Enter.

Options D1, D2, D3, D4, and I1, which are also available when CONTROL-V is
installed as a standalone product, are described on the following pages. For the
descriptions of other utilities on the menu, see the user guides of the relevant
products.

Online utility screens utilize standard ISPF profile capabilities.

Quick transfer to a utility can be performed by entering =opt from another utility
screen, or =6.opt from a non-utility screen (for example, the IOA Log screen), where
opt is the 2-character option identified on the IOA Online Utilities menu.

D1: Schedule a Report Decollating Mission

This utility schedules one or more categories of a report decollating mission.

408 CONTROL-D and CONTROL-V User Guide

 D1: Schedule a Report Decollating Mission

The utility screen shown in Figure 201 can be displayed in the following ways:

Select option D1 - DECOLLATING in the Online Utilities menu.

Invoke the CTDMISRQ CLIST with parameter MIS(REP) from the TSO Command
Processor screen.

Figure 201 Report Decollating Mission Scheduling Utility Screen

-------------- REPORT DECOLLATING MISSION SCHEDULING UTILITY -------------
COMMAND ===>

MISSION LIBRARY ===> CTDW.WORKO.REPORTS

MISSION/JOB NAME ===> SALARYRP

CATEGORY ===> * (* for all categories)

SCHEDULED RUN DATE ===> 08 08 00 (ODATE - format DD MM YY)

FORCED SCHEDULING ===> NO (YES,NO)

ENTER YES TO CONTINUE ===> YES

CALENDAR LIBRARY ===> IOAW.WORKO.CAL

To activate the utility, fill in the following fields and press Enter.

Table 192 Fields of the Prerequisite Condition Utility Screen

Field Description
MISSION LIBRARY Library that contains the mission you want to schedule. The default
report decollating mission library is displayed.
MISSION/JOB Name of the mission you want to schedule.
NAME
CATEGORY Name of the mission category you want to schedule. Enter an asterisk
(*) to schedule all categories of the mission.
SCHEDULED RUN Original scheduling date for the mission in DD MM YY format. The
DATE default is the current working date.
FORCED Yes/No indicator that determines whether or not scheduling is
SCHEDULING forced.

YES Schedule a mission category even if the run date is not

specified in the Basic Scheduling parameters.

NO Schedule a mission category only if the run date is specified

in the Basic Scheduling parameters. This may result in no
scheduling. Default.
ENTER YES TO Confirmation field to prevent the unintentional scheduling of a
CONTINUE mission. Enter YES to schedule the mission.
CALENDAR Library that contains any calendars specified in the mission. The
LIBRARY default calendar library is displayed.

Chapter 2 Online Facilities 409

D2: Schedule a Printing Mission

To exit the screen without activating the utility, press PF03/PF15.

D2: Schedule a Printing Mission

This utility schedules a printing mission.

The utility screen shown in Figure 202 can be displayed in the following ways:

Select option D2 - PRINT in the Online Utilities menu.

Activate CLIST CTDMISRQ with parameter MIS(PRT) from the TSO Command
Processor.

Figure 202 Print Mission Scheduling Utility Screen

--------------------- PRINT MISSION SCHEDULING UTILITY --------------------
COMMAND ===>

MISSION LIBRARY ===> CTDW.WORKO.PRTMIS

MISSION/JOB NAME ===> SALARYRP

CATEGORY ===> * (* for all categories)

SCHEDULED RUN DATE ===> 08 08 00 (ODATE - format DD MM YY)

FORCED SCHEDULING ===> NO (YES,NO)

ENTER YES TO CONTINUE ===> YES

CALENDAR LIBRARY ===> IOAW.WORKO.CAL

To activate the utility, fill in the following fields and press Enter.

Table 193 Print Mission Scheduling Utility Screen (part 1 of 2)

Field Description
MISSION LIBRARY Library that contains the mission you want to schedule. The default
print mission library is displayed.
MISSION/JOB Name of the mission you want to schedule.
NAME
CATEGORY Name of the mission category you want to schedule. Enter an asterisk
(*) to schedule all categories of the mission.
SCHEDULED RUN Original scheduling date for the mission in DD MM YY format. The
DATE default is the current working date.

410 CONTROL-D and CONTROL-V User Guide

 D3: Schedule a Backup / Migration Mission

Table 193 Print Mission Scheduling Utility Screen (part 2 of 2)

Field Description
FORCED Yes/No indicator that determines whether or not scheduling is
SCHEDULING forced.

YES Schedule a mission category even if the run date is not

specified in the Basic Scheduling parameters.

NO Schedule a mission category only if the run date is specified

in the Basic Scheduling parameters. This may result in no
scheduling. Default.
ENTER YES TO Confirmation field to prevent the unintentional scheduling of a
CONTINUE mission. Enter YES to schedule the mission or press PF03/PF15 to
return to the previous screen.
CALENDAR Library that contains any calendars specified in the mission. The
LIBRARY default calendar library is displayed.

To exit the screen without activating the utility, press PF03/PF15.

D3: Schedule a Backup / Migration Mission

This utility schedules a backup mission or a migration mission.

The utility screen shown in Figure 203 can be displayed in the following ways:

Select option D3 BACKUP / MIGRATION in the Online Utilities menu.

Chapter 2 Online Facilities 411

D3: Schedule a Backup / Migration Mission

Figure 203 Backup Mission Scheduling Utility Screen

Activate CLIST CTDMISRQ with parameter MIS(BKP) from the TSO Command Processor.
-------------- BACKUP / MIGRATION MISSION SCHEDULING UTILITY -------------
COMMAND ===>

MISSION LIBRARY ===> CTVW.WORKO.MIGMIS

MISSION/JOB NAME ===> MIG0007D

CATEGORY ===> * (* for all categories)

SCHEDULED RUN DATE ===> 08 08 00 (ODATE - format DD MM YY)

FORCED SCHEDULING ===> NO (YES,NO)

ENTER YES TO CONTINUE ===> YES

CALENDAR LIBRARY ===> IOAW.WORKO.CAL

To activate the utility, fill in the following fields and press Enter:

Table 194 Backup Mission Scheduling Utility Screen Fields

Field Description
MISSION LIBRARY Library that contains the mission you want to schedule. The default
backup / migration mission library is displayed.
MISSION/JOB Name of the mission you want to schedule.
NAME
CATEGORY Name of the mission category you want to schedule. Enter an asterisk
(*) to schedule all categories of the mission.
SCHEDULED RUN Original scheduling date for the mission in DD MM YY format. The
DATE default is the current working date.
FORCED Yes/No indicator that determines whether or not scheduling is
SCHEDULING forced.

YES Schedule a mission category even if the run date is not

specified in the Basic Scheduling parameters.

NO Schedule a mission category only if the run date is specified

in the Basic Scheduling parameters. This may result in no
scheduling. Default.
ENTER YES TO Confirmation field to prevent the unintentional scheduling of a
CONTINUE mission. Enter YES to schedule the mission or PF03/PF15 to return to
the previous screen.
CALENDAR Library that contains any calendars specified in the mission. The
LIBRARY default calendar library is displayed.

412 CONTROL-D and CONTROL-V User Guide

 D4: Schedule a Restore Mission

To exit the screen without activating the utility, press PF03/PF15.

D4: Schedule a Restore Mission

This utility schedules a restore mission.

The utility screen shown in Figure 204 can be displayed in the following ways:

Select option D4 - RESTORE in the Online Utilities Menu.

Activate CLIST CTDMISRQ with parameter MIS(RST) from the TSO Command
Processor.

Figure 204 Restore Mission Scheduling Utility Screen

------------------- RESTORE MISSION SCHEDULING UTILITY ------------------
COMMAND ===>

MISSION LIBRARY ===> CTDW.WORKO.RSTMIS

MISSION/JOB NAME ===> RESTORE1

CATEGORY ===> * (* for all categories)

SCHEDULED RUN DATE ===> 08 08 00 (ODATE - format DD MM YY)

FORCED SCHEDULING ===> NO (YES,NO)

ENTER YES TO CONTINUE ===> YES

CALENDAR LIBRARY ===> IOAW.WORKO.CAL

To activate the utility, fill in the following fields and press Enter.

Table 195 Restore Mission Scheduling Utility Screen Fields (part 1 of 2)

Field Description
MISSION LIBRARY Library that contains the mission you want to schedule. The default
restore mission library is displayed.
MISSION/JOB Name of the mission you want to schedule.
NAME
CATEGORY Name of the mission category you want to schedule. Enter an asterisk
(*) to schedule all categories of the mission.
SCHEDULED RUN Original scheduling date for the mission in DD MM YY format. The
DATE default is the current working date.

Chapter 2 Online Facilities 413

D4: Schedule a Restore Mission

Table 195 Restore Mission Scheduling Utility Screen Fields (part 2 of 2)

Field Description
FORCED Yes/No indicator that determines whether or not scheduling is
SCHEDULING forced.

YES Schedule a mission category even if the run date is not

specified in the Basic Scheduling parameters.

NO Schedule a mission category only if the run date is specified

in the Basic Scheduling parameters. This may result in no
scheduling. Default.
ENTER YES TO Confirmation field to prevent the unintentional scheduling of a
CONTINUE mission. Enter YES to schedule the mission or press PF03/PF15 to
return to the previous screen.
CALENDAR Library that contains any calendars specified in the mission. The
LIBRARY default calendar library is displayed.

To exit the screen without activating the utility, press PF03/PF15.

414 CONTROL-D and CONTROL-V User Guide

 I1: Add, Check, or Delete a Prerequisite Condition

I1: Add, Check, or Delete a Prerequisite Condition

This utility adds prerequisite conditions to, checks the existence of prerequisite
conditions in, and deletes prerequisite conditions from, the IOA Conditions file.

The Prerequisite Condition Utility screen, shown in Figure 205, can be displayed in
the following ways:

Select option I1 in the Online Utilities menu.

Invoke the IOACCND CLIST from the TSO Command Processor screen.

Figure 205 Prerequisite Condition Utility Screen

----------------------- PREREQUISITE CONDITION UTILITY ---------------------
COMMAND ===>

FUNCTION ===> ADD (ADD/CHECK/DELETE)

CONDITION NAME ===> SALARY_RPT_OK

Enter either date or STAT:

CONDITION DATE ===> STAT (DDMM OR STAT)

ENTER YES TO CONTINUE ===> YES

To activate the utility, fill in the following fields and press Enter:

Chapter 2 Online Facilities 415

I1: Add, Check, or Delete a Prerequisite Condition

Table 196 Prerequisite Condition Utility Screen Fields

Field Description
FUNCTION Function to be performed. Valid values are:

ADD Add the specified condition to the IOA Conditions file.

CHECK Check if the specified condition exists in the IOA
Conditions file.
DELETE Delete the specified condition from the IOA Conditions
file.
CONDITION Name of the prerequisite condition (1 through 39 characters) to be
NAME added, checked, or deleted. If CONDITION NAME values contain the
special characters ampersand (&) or apostrophe (), they must be
repeated in order to appear on the screen.
CONDITION 4-character date associated with the specified condition. Valid values
DATE are:

date Valid date in date in mmdd or ddmm format, depending on

the site standard.
STAT Static. Value assigned to conditions that are not
date-dependent, such as DATABASE-OK.
ENTER YES TO Confirmation field to prevent the unintentional addition or deletion of
CONTINUE a condition. When blank, the operation is not performed. Type YES to
add, check or delete the condition.

To exit the screen without activating the utility, press PF03/PF15.

416 CONTROL-D and CONTROL-V User Guide

 Chapter

3
3 Decollating Mission Parameters
This chapter contains the following topics:

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
Report Decollating Mission Definition Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
Basic Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423
Runtime Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
Post-Processing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
Decollating Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427
CATEGORY: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
CONFCAL: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433
DATES: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436
DAYS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438
DESC: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 448
DO Statement: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 450
DO BACKUP: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
DO BACKUP: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 452
DO COND: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 454
DO CTBRULE: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 459
DO INDEX: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 462
DO LEVEL: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
DO MIGRATE: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
DO NAME: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 483
DO NOTOK: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 490
DO PRINT: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
DO REMARK: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
DO SET: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
DO SHOUT: Post-Processing Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509
DO USER: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
DO USER: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 513
DSN: Runtime Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
GENERIC: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524
GROUP: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526
IN: Runtime Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528
INTERVAL: Runtime Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
JOB DEFAULTS COPIES: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534

Chapter 3 Decollating Mission Parameters 417

 JOB DEFAULTS DEST: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 536
JOB DEFAULTS LVL: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538
JOB DEFAULTS MAX COPIES: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . 540
JOB DEFAULTS USER: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542
JOBID: General Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544
JOBNAME: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
MAXWAIT: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
MINIMUM: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
MONITOR: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
MONTHS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
MQ: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 558
ON Statement: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 560
ON Statement Defaults: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 572
OUT: PostProcessing Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
OWNER: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
PDS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584
PRINT/CDAM PARMS: Decollating Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
PRIORITY: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 592
RETRO: Basic Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594
SET: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597
SHOUT: Post Processing Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599
TASKTYPE: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
TIME: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
WDAYS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
WHEN: Decollating Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 619
WHEN IN QUEUE/CLS: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . 628

418 CONTROL-D and CONTROL-V User Guide

 Overview

Overview
The various rules and operating instructions governing each report decollating
mission performed under CONTROL-V are called report decollating mission
parameters. This chapter describes these parameters and their usage.

Report decollating mission parameters only need to be defined once for each mission.
CONTROL-V uses these parameters for numerous executions of the same report
decollating mission at different times. Of course, CONTROL-V lets you modify the
parameters at any time.

The report decollating mission parameters are defined via the Online facility using
preformatted screens.

Report Decollating Mission Definition Screen

Figure 206 Report Decollating Mission Definition Screen
------- CONTROL-D/V CATEGORY DAILY JOB * ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME * GENERIC Y MONITOR 1
OWNER M22 TASKTYPE REP GROUP MSGCLASS-JCL JOBID
DESC GENERIC - FOR ALL PRODUCTION MSGCLASS (JCL)
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URG R
MSG GENERIC DECOLLATING MISSION --> PRODJCL ENDED N O T O K !!!!
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 419

Report Decollating Mission Definition Screen

Figure 207 Report Decollating Mission Definition Screen (continued)

------- CONTROL-D/V CATEGORY DAILY JOB * ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
===========================================================================
ON CLASS = W EXTWTR DEST FORM
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
PRINT/CDAM PARMS =
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO NAME = PRODUCTION JCL
DO USER = PRODCNTL LVL LINE COL -
S A T SYNONYM = CONCAT =
DO BACKUP = BKP0007D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
ON
PRT COPIES LVL USER DEST MAX COPIES
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.44.02

It is suggested that all CONTROL-V users read Report Decollating Mission

Definition Facility on page 108, before proceeding with this chapter.

All parameter definitions are stored as members in standard user libraries. One
member must exist for each job and the member name must be identical to the job
name. Each job is composed of operating instructions for one or more report
decollating mission categories (such as DAILY or MONTHLY). Maintenance within
the library and management of the report decollating mission operating instructions
are carried out using the Mission Definition facility.

This chapter contains a description of the instructions for a single report decollating
mission category in a job.

The following types of report decollating mission parameters can be specified:

420 CONTROL-D and CONTROL-V User Guide

 Report Decollating Mission Definition Screen

What to do?
General Parameters specify which report decollating mission to run, the mission
type (regular, emergency, cyclic, and so on. Parameters include:

CATEGORY
DESC
GENERIC
GROUP
JOBID
JOBNAME
MONITOR
OWNER
TASKTYPE

When?
Basic Scheduling Parameters specify the day or time to execute the mission.
Parameters include:

CONFCAL
DATES
DAYS
MAXWAIT
MINIMUM
MONTHS
PDS
RETRO
WDAYS

Runtime Environment.
Runtime Scheduling Parameters specify requirements that must be satisfied to
execute the mission. Parameters include:

DSN
IN
INTERVAL
PRIORITY
TIME
WHEN IN QUEUE/CLS

Chapter 3 Decollating Mission Parameters 421

General Parameters

Results Control.
Post-processing Parameters specify what to do when the mission finishes
processing (OK or NOTOK). Parameters include:

OUT
SHOUT

Decollating Instructions.
Decollating Parameters specify how to decollate and index the reports of the job.
Parameters include:

DO BACKUP
DO COND
DO CTBRULE
DO INDEX
DO LEVEL
DO MIGRATE
DO NAME
DO NOTOK
DO PRINT
DO REMARK
DO SET
DO SHOUT
DO USER
JOB DEFAULTS
ON Statement
ON Statement Defaults
PRINT/CDAM PARMS
SET
WHEN

A brief summary of the parameters in each type is provided below. This is followed
by a detailed description of each parameter in alphabetical order.

General Parameters
Decollating mission General parameters specify which report decollating mission to
run, the mission type (regular, cyclic, emergency, and so on.

The following General parameters are described in this chapter:

422 CONTROL-D and CONTROL-V User Guide

 Basic Scheduling Parameters

Table 197 Decollating Mission General Parameters

Parameter Description
CATEGORY Category of the report decollating mission parameters (for example,
DAILY, MONTHLY, WORKDAY).
JOBNAME Name of the job that should be decollated.
GENERIC Indicator that specifies whether the report decollating mission is Generic
or MQ.
MONITOR Monitor IDs of the CONTROL-V monitor that should decollate the job.
OWNER User ID of the user who requests CONTROL-V services (for security
purposes).
TASKTYPE Type of report decollating mission to be performed (for example,
regular, emergency or cyclic).
GROUP Descriptive name for a group of missions.
JOBID JES job number of the job that created the report.
DESC Description of the report decollating mission (free text).

Basic Scheduling Parameters

Basic Scheduling Parameters determine on which day a report decollating mission is
scheduled in (ordered to) the Active Missions file.

The New Day procedure determines if the report decollating mission is a candidate
for execution on a specific date (that is, the job is expected to run that day). If a report
decollating mission is a candidate for execution on a specific date, the report
decollating mission is placed in the Active Missions file.

Each report decollating mission in the Active Missions file has an original scheduling
date associated with it. This is the date the job should be decollated according to the
Basic Scheduling parameters. This date is not necessarily the same as the current
system date or the working date.

NOTE
Basic Scheduling parameters may be ignored by the CONTROL-V New Day procedure,
depending on the mode of operation. For more information, see the CONTROL-D and
CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide. If Basic Scheduling
parameters are irrelevant to the mode of operation used at your site, ignore the information in
this chapter about Basic Scheduling parameters.

Basic Scheduling parameters are divided into the four groups listed below.
Parameters must be selected from only one of the first three groups (A, B or C). Use of
the fourth group (D) is optional.

Chapter 3 Decollating Mission Parameters 423

Basic Scheduling Parameters

Table 198 Basic Scheduling Parameter Groups

Group Parameter Description
A DAYS Days of the month to activate the mission.
WDAYS Days of the week to activate the mission Sunday, Monday,
and so on.
MONTHS Months to activate the mission.
CONFCAL Name of a user-defined calendar used for confirming schedule
dates.
B DATES Specific dates in the year (day and month) to activate the
mission.
C PDS Name of a partitioned dataset (library) to be checked for
minimum free space.
MINIMUM Minimum number of free tracks required for the library
defined in parameter PDS.
D RETRO Indicator that specifies whether the mission is scheduled for
execution after its original scheduling date has passed.
MAXWAIT Maximum number of days a mission should remain available
for execution after its original scheduling date has passed.

Each Basic Scheduling parameter is described in this chapter. However, the

interrelationships between some of these parameters are described briefly below.

DAYS/DCAL WDAYS/WCAL
These parameters are all optional.

Parameter DAYS identifies days of the month on which the report decollating
mission should be scheduled (for example, 1st day of the month, 3rd working day of
the month). Several formats are available for specifying DAYS values.

Parameter WDAYS identifies days of the week on which the report decollating
mission should be scheduled. For example, the 1st day of the week, the 2nd working
day of each week. Several formats are available for specifying WDAYS values.

A calendar name can be specified in the DCAL and/or WCAL fields. A calendar
specifies days of the year on which a rule can be scheduled, known as working days.
For more information on calendars and the IOA Calendar Facility, see IOA Calendar
Facility on page 390.

When both DAYS and DCAL are specified, they work as a complementary unit, as
described later in this chapter. Similarly, when both WDAYS and WCAL are
specified, they also work as a complementary unit, as described later in this chapter.

424 CONTROL-D and CONTROL-V User Guide

 Basic Scheduling Parameters

When values for both DAYS (/DCAL) and WDAYS (/WCAL) are specified in the
same report decollating mission, the resulting schedule is determined by the value
specified in field AND/OR.

CONFCAL/SHIFT
A calendar specified in CONFCAL is not used for report decollating mission
scheduling but is used instead for validating a scheduled date. Only report
decollating missions that have satisfied all other specified basic scheduling criteria
are checked against the CONFCAL calendar. If the day is a working day in the
CONFCAL calendar, the report decollating mission is scheduled on that day.
Otherwise, the report decollating mission is either shifted to (scheduled on) another
day according to the value specified in parameter SHIFT, or the report decollating
mission is not scheduled (if no SHIFT value has been specified).

CONFCAL calendars are useful for handling holidays and other scheduling
exceptions.

Defining a Schedule Internal Scheduling Logic

When defining report decollating missions, it is useful to understand the IOA

Scheduling facility logic that determines whether or not to order a report decollating
mission on a specific day. This logic is described below.

1. DAYS/DCAL parameters are checked independently and a first tentative

scheduling decision is created.

2. WDAYS/WCAL parameters are checked independently and a second tentative

scheduling decision is created.

3. A third tentative scheduling decision is created based on the above two decisions
and the AND/OR value linking them.

If DAYS/DCAL are not specified, this third scheduling decision is identical to the
second scheduling decision. If WDAYS/WCAL are not specified, this third
scheduling decision is identical to the first scheduling decision.

4. If CONFCAL/SHIFT are specified, the third scheduling decision is adjusted

according to the CONFCAL/SHIFT criteria.

5. This third decision (as adjusted) becomes the final scheduling decision. The IOA
Scheduling facility decides whether or not to schedule a report decollating mission
based on this final scheduling decision.

Chapter 3 Decollating Mission Parameters 425

Runtime Scheduling Parameters

Runtime Scheduling Parameters

The CONTROL-V monitor determines whether or not the conditions required for
decollation of the job are satisfied. If they are, the decollating mission can process the
jobs reports.

The following Runtime Scheduling parameters are described in this chapter:

Table 199 Runtime Scheduling Parameters

Parameter Description
IN Prerequisite conditions for the execution of the report
decollating mission.
WHEN IN QUEUE/CLS Flag and output class parameters that determine where
CONTROL-V should look to find the job whose output should
be decollated.
TIME Time of day limits (from, until) for executing the report
decollating mission.
INTERVAL Minimum time to wait between successive executions of a
cyclic report decollating mission.
PRIORITY Report decollating mission priority (compared to other
missions).
DSN Compressed dataset name selection criteria for the entire job.

Post-Processing Parameters
Post-processing parameters define actions to be taken after the report decollating
mission has finished processing the jobs outputs. The two Post-processing
parameters are:

Table 200 Post-Processing Parameters

Parameter Description
OUT Defines a list of prerequisite conditions to be added or deleted after the
report decollating mission finishes executing OK. These prerequisite
conditions can be referred to by IN statements of other missions (such as
printing missions).
SHOUT Specifies messages to be sent to specified destinations upon the occurrence
of specific events. Currently, OK, NOTOK and LATE are supported.

Various internal CONTROL-V rules are applied to determine whether or not the
report decollating mission ended OK. The most significant events that cause a
NOTOK indication are:

426 CONTROL-D and CONTROL-V User Guide

 Decollating Parameters

When NOTOK is specifically declared in a DO NOTOK statement. For more

information, see DO NOTOK later in this chapter.

When no sysout is selected by the ON statements (for example, when someone

purges the jobs reports from the spool or from the compressed datasets).
However, an installation parameter can be set to avoid a NOTOK status in this
situation.

When any page in the reports decollated by the report decollating mission is
unidentified.

There are other events that can cause a NOTOK status (for example, no space for
compressed reports, spool I/O error). When a NOTOK status is encountered, use the
L (Log) option of the CONTROL-V Active Missions screen to receive a list of reasons
for the NOTOK status.

NOTE
Prerequisite conditions can also be added or deleted and SHOUT messages can also be sent
using DO COND and DO SHOUT statements. For more information, see DO COND and
DO SHOUT later in this chapter.

Decollating Parameters
The main purpose of decollating parameters is to identify the intended recipients of
each page of the jobs reports. Indexing, printing, migrating and backup instructions
can also be specified.

Decollating parameters describe how to decollate the jobs reports. The first
Decollating parameters are the default decollating parameters, called JOB
DEFAULTS. They provide decollating instructions to be used on report pages for
which decollating instructions are not defined in an ON block.

SET Statement
The SET statement assigns an initial value to a system variable that is used during this
decollation process or a regular variable that can be used in this decollation mission.

ON Blocks
Each ON statement starts an ON block. An ON block is comprised of an ON
statement, ON Statement DEFAULTS and one or more WHEN statements paired
with DO statements.

Chapter 3 Decollating Mission Parameters 427

Decollating Parameters

Below the default Decollating parameters on the screen, any number of ON blocks
can be defined. Each ON block provides instructions for decollating a particular set of
the jobs reports. The selection of reports covered by a single ON block can be
specified by sysout CLASS, by CDAM parameters, by SYSOUT step or procedure
name, or as SYSDATA, SYSLOG, SYSJCL or SYSMSG datasets.

NOTE
Decollating instructions included in an ON block override the general JOB DEFAULTS
defined at the beginning of the decollating parameters.

ON Statement DEFAULTS can be specified within each ON block. These provide

default decollating instructions for report pages in the ON block.

WHEN Statements
Within an ON block, WHEN LINE/COL statements identify report pages for which
particular handling is desired. Identification is accomplished by means of a character
string search at specified location on a report page. Multiple WHEN LINE/COL
statements can be defined within a single ON block.

DO Statements
DO statements define the action to be taken on pages identified by a WHEN
LINE/COL statement. Using DO statements, the following can be specified:

Recipient of the page or report segment.

Name of the backup mission that should back up the report.
Name of a printing mission that can print the report.
Report name, which can later be used for retrieval.
Indexes, which can later be used for retrieval by index values.
Name of the migration missions that should migrate the report and its indexes.
Prerequisite conditions to be added and/or deleted.
SHOUT messages to be sent to a specified destination.
Indication that report decollating should end NOTOK.
Remarks that appear in certain User Report lists.
Multiple DO statements can be defined for a single WHEN LINE/COL statement.

Information about the following decollating parameters is provided in this chapter:

428 CONTROL-D and CONTROL-V User Guide

 Decollating Parameters

Table 201 Decollating Parameters

Parameter Description
JOB DEFAULTS General default decollating parameters for report pages.
ON Statement The part of the jobs reports on which the decollation
instructions within the ON block are to be carried out.
ON PRINT DEFAULTS Default printing values for the ON block.
PRINT/CDAM PARMS Parameters which, if specified, override the original printing
characteristics of the reports decollated under the ON
statement.
WHEN LINE/COL Page identification criteria.
DO BACKUP Names of the backup missions that back up the sysout.
DO COND Prerequisite conditions to be added and/or deleted if a
specified string is found by the WHEN statement.
DO CTBRULE CONTROL-M/Analyzer rule to be executed including
optional arguments.
DO INDEX Name of an index for the report. Multiple indexes can be
defined for each report.
DO LEVEL Level of user (and/or name of user) to whom the page
identified in the WHEN statement is sent.
DO MIGRATE Name of the migration mission which transfers the report
from one storage media to another.
DO NAME Name of the report identified by the WHEN statement.
DO NOTOK Indicator that generates a NOTOK status if a specified string is
found by the WHEN statement.
DO PRINT Names of the printing missions that print the report.
DO REMARK Remarks to be generated if a specified string is found by the
WHEN statement.
DO SET Assigns a value to a variable that can be used by other
decollation parameters.
DO SHOUT Message to be sent to a specified destination if a specified
string is found by the WHEN statement.
DO USER Name of the user (or level of user) to whom the page
identified in the WHEN statement is sent.

Each of the parameters listed above is documented on the following pages.

Figure 207 Parameter Descriptions

The following pages contain detailed descriptions of all parameters available in the
CONTROL-D Report Decollating Mission screen. Parameters are arranged in
alphabetical order. Within each parameter, subparameters are arranged according to
the order of the fields on the screen.

Each parameter begins on a new page, including:

Chapter 3 Decollating Mission Parameters 429

Decollating Parameters

A brief explanation of the parameters purpose.

The format required for defining the parameter within an extract of the
CONTROL-D screen.

General information explaining the parameter and its usage.

Where applicable, some practical examples illustrating implementation of the

parameter.

For more information on the Report Decollating Mission facility, see Report
Decollating Mission Definition Facility on page 108.

430 CONTROL-D and CONTROL-V User Guide

 CATEGORY: General Parameter

CATEGORY: General Parameter

Category of the report decollating mission.

Figure 208 CATEGORY Parameter Format

Mandatory. Parameter CATEGORY specifies a category name of 1 through 20

characters. Only trailing blanks are allowed.

General Information
Decollating parameters for each job can be specified under different categories. It is
possible to use different decollating criteria for different scheduling dates (for
example, regular workday, end of month). Each set of decollating criteria is called a
category.

Any number of categories (decollating criteria) can be defined for each job. It is
recommended that in early stages of CONTROL-V implementation, only one basic
category be used for all jobs, such as DAILY.

Whenever the job is scheduled, the specified category is placed in the Active Missions
file.

Example
The name of the category for this report decollating mission is DAILY.

Chapter 3 Decollating Mission Parameters 431

CATEGORY: General Parameter

Figure 209 CATEGORY Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR 1
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE DAILY REPORTS FOR ALL DEPARTMENTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

432 CONTROL-D and CONTROL-V User Guide

 CONFCAL: Basic Scheduling Parameter

CONFCAL: Basic Scheduling Parameter

Name of a calendar used to confirm the scheduling of the report decollating mission.
See also DAYS, WDAYS and DATES.

Figure 210 CONFCAL Parameter Format

Optional. CONFCAL parameters are described below:

Table 202 CONFCAL Subparameters

Parameter Description
CONFCAL Specifies a valid calendar (member) name of 1 through 8 characters.

A calendar specified in CONFCAL is used for validating schedule dates.

Missions to be scheduled on a day, based on other specified scheduling
criteria, are checked against the CONFCAL calendar. If the day is a
working day in the CONFCAL calendar, the mission is scheduled on that
day. Otherwise, parameter SHIFT determines whether the mission is
shifted to (scheduled on) another day or is not scheduled.
SHIFT When a mission fails confirmation for scheduling on a given day because
the day is not a working day in the CONFCAL calendar, SHIFT
determines if and when the mission is alternatively scheduled. Valid
values are:

blankNo shifting occurs. The mission is not scheduled. Default.

> Mission is scheduled on (shifted to) the next working day,
according to the CONFCAL calendar.
< Mission is scheduled on (shifted to) the previous working day,
according to the CONFCAL calendar.
Note: Specifying a SHIFT value does not ensure that the mission is
scheduled. SHIFT cannot add scheduling dates; it can only shift a mission
to a scheduling date that is already defined. If SHIFT does not find a
suitable date in the other scheduling criteria, the mission is not scheduled.

Chapter 3 Decollating Mission Parameters 433

CONFCAL: Basic Scheduling Parameter

General Information
CONFCAL calendars are especially useful for handling holidays and other
scheduling exceptions.

If not specified, missions are scheduled according to other scheduling criteria without
confirmation.

CONFCAL should not contain the name of a periodic calendar. If it does, no day
passes the confirmation.

SHIFT cannot be specified unless CONFCAL is specified. When CONFCAL is

specified, SHIFT is optional (that is, blank defaults to no shifting).

CONFCAL cannot be used with parameters PDS and MINIMUM.

Example
This example is based on the following assumptions:

The current month is September 2001.

Working days are defined in calendar WORKDAYS, which contains the following
working days (indicated by Y) for September 2001:
---S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 +
Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y

Start of the week is defined as Monday. Weeks start on the following dates in
September: 3rd, 10th, 17th, and 24th.

Schedule the decollating mission on the 1st, 7th and 15th day of the month if they are
both Saturdays and working days in WORKDAYS. If the day of the month (1st, 7th,
15th) is not a Saturday, do not schedule the decollating mission. If the day of the
month is a Saturday but is not a working day, schedule the decollating mission on the
next working day.

DAYS - 1,7,15
AND/OR - AND
WDAYS - 6
CONFCAL - WORKDAYS
SHIFT - >

434 CONTROL-D and CONTROL-V User Guide

 CONFCAL: Basic Scheduling Parameter

The decollating mission is scheduled on the days of the month indicated by an

asterisk:

Figure 211 CONFCAL Parameter Example

Chapter 3 Decollating Mission Parameters 435

DATES: Basic Scheduling Parameter

DATES: Basic Scheduling Parameter

Dates, by month and day, on which the report decollating mission should be
scheduled for execution.

Figure 212 DATES Parameter Format

Optional. Valid values are 4-character dates in mmdd or ddmm format, depending
on the site standard.

A maximum of 12 dates can be specified.

General Information
The report decollating mission is scheduled for execution only on the dates specified
in parameter DATES.

Parameter DATES cannot be used with parameters PDS, MINIMUM, MONTHS,

DAYS and DCAL.

To specify more than 12 dates for one report decollating mission, define the dates in a
calendar (instead of using this parameter) and specify the calendar in DCAL (or
WCAL).

The relationship between DATES and WDAYS/WCAL is OR. If the report

decollating mission should be scheduled according to the DATES parameter or
according to the WDAYS/WCAL combination, it is scheduled.

436 CONTROL-D and CONTROL-V User Guide

 DATES: Basic Scheduling Parameter

Examples

Example 1

Schedule a report decollating mission for the 15th of January (mmdd format):

DATES=0115

Example 2

Schedule a report decollating mission for the 21st of June and the 21st of December
(ddmm format):

Figure 213 DATES Parameter Example 2

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT20S ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT20S GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE REPORT FOR THE GENERAL MANAGER
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES 2106 2112
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 437

DAYS: Basic Scheduling Parameter

DAYS: Basic Scheduling Parameter

Days of the month on which the report decollating mission should be scheduled. See
also CONFCAL and WDAYS.

Figure 214 DAYS Parameter Format

Optional. Parameter DAYS specifies days of the month on which the report
decollating mission should be scheduled, only if other basic scheduling criteria are
met. Values for DAYS can be specified alone, or they can be specified together with a
calendar specified in subparameter DCAL. DAYS/DCAL can also be specified
together with WDAYS/WCAL (described under WDAYS in this chapter).

Parameter DAYS consists of the following subparameters:

Table 203 DAYS Subparameters (part 1 of 2)

Subparameter Description
DAYS Days of the month on which to schedule a report decollating mission.
(The months in which to order report decollating missions are
specified in parameter MONTHS, described later in this chapter.)
Various formats (described later) can be used to specify DAYS (for
example, 3 means the 3rd day of the month, L2 means the day before
the last day of the month, D1PA means the 1st day in period A).
DCAL Name of a calendar containing a predefined set of dates (referred to as
working days) on which a report decollating mission should be
scheduled. A specified value must be a valid member name of 1
through 8 characters, or an * to indicate that the calendar specified in
parameter CONFCAL should be used for scheduling. For more
information on how to define, use and modify calendars, see IOA
Calendar Facility on page 390.
Note: A calendar specified in DCAL does not have to exist when
defining parameter DAYS. However, it must exist when the report
decollating mission is being ordered.

438 CONTROL-D and CONTROL-V User Guide

 DAYS: Basic Scheduling Parameter

Table 203 DAYS Subparameters (part 2 of 2)

Subparameter Description
AND/OR Conjunctional parameter used to link parameters DAYS and WDAYS
when both are specified.

A (AND)Both DAYS (/DCAL) and WDAYS (/WCAL) criteria

must be met to schedule a report decollating mission.
O (OR)DAYS (/DCAL) and WDAYS (/WCAL) criteria must be
met to schedule a report decollating mission. Default.

If A (AND) is specified when either DAYS or WDAYS is specified (but

not both), the missing DAYS or WDAYS value is automatically set to
ALL.

Assuming all other basic scheduling criteria are met:

When DAYS are specified without DCAL, the report decollating mission is
scheduled on the specified days (in the specified months).

When DCAL is specified without DAYS, the report decollating mission is

scheduled on all working days marked in the DCAL calendar.

When DAYS and DCAL are both specified, scheduling depends on the
combination of working days defined in the calendar and the values and format of
parameter DAYS (described below).

When both DAYS and WDAYS criteria are specified, scheduling depends on the
AND/OR parameter connecting them.

Valid Formats for Parameter DAYS

Valid formats for parameter DAYS, and how they relate to DCAL, are described
below.

In the following non-periodic scheduling formats:

n is an integer from 1 through 31.

Multiple values can be specified (separated by commas) in any order.
DCAL should not contain the name of a periodic calendar.

Chapter 3 Decollating Mission Parameters 439

DAYS: Basic Scheduling Parameter

Table 204 Non-Periodic Scheduling Formats

Format Description
ALL All days in the month. If ALL is specified, other DAYS values cannot be
specified with it.

If a DCAL calendar is not defined, schedule the mission on all days in the
month. If a DCAL calendar is defined, schedule the mission only on the
working days indicated in the calendar.
n,... Specific days of the month.

If a DCAL calendar is not defined, schedule the mission on the specified days.
If a DCAL calendar is defined, schedule the mission only when a day is
defined as a working day in both the DAYS parameter and the DCAL calendar.
+n,... Days of the month in addition to the working days specified in the DCAL
calendar. DCAL is mandatory.
n,... Schedule the mission on all days except the nth day from the beginning of the
month. DCAL is mandatory.
>n,... Schedule the report decollating mission on the indicated day if it is a working
day in the DCAL calendar; otherwise, schedule the report decollating mission
on the next working day that is not negated by a n value in this parameter.
This format is frequently used for holiday handling. DCAL is mandatory.
<n,... Schedule the report decollating mission on the indicated day if it is a working
day in the DCAL calendar; otherwise, schedule the report decollating mission
on the last previous working day that is not negated by a n value in this
parameter. This format is frequently used for holiday handling. DCAL is
mandatory.
Dn,... Schedule the report decollating mission on the nth working day from the
beginning of the month. DCAL is mandatory.
Dn,... Schedule the report decollating mission on all working days except the nth
working day from the beginning of the month. DCAL is mandatory.
Ln,... Schedule the report decollating mission on the nth day (or nth working day if
DCAL is defined) counting backward from the end of the month. DCAL is
optional.
Ln,... If DCAL is defined, schedule the report decollating mission on all working
days except the nth working day counting backward from the end of the
month. If DCAL is not defined, schedule the report decollating mission on all
days except the nth day counting backward from the end of the month. DCAL
is optional.

In the following periodic scheduling formats:

n is an integer from 1 through 63 and i is any valid period identifier. An * can be

specified as the i value to represent all periods. An * can be specified as the n value
in format DnPi to represent all days. (* is not a valid n value in formats DnPi, LnPi
and LnPi.)

440 CONTROL-D and CONTROL-V User Guide

 DAYS: Basic Scheduling Parameter

A period can span any number of days, but by default, no more than 33 days can
elapse after the appearance of one identifier in a period until the appearance of the
next matching identifier in the same period. Once a gap of 33 days has been
reached, the period automatically closes. (The 33-day default can be changed by
the INCONTROL administrator.)

The name of a periodic calendar must be specified in DCAL. For details concerning
periodic calendars, see IOA Calendar Facility on page 390.

Table 205 Periodic Scheduling Formats

Format Description
DnPi,... Schedule the report decollating mission on the nth day of period i from the
beginning of the period.
DnPi,... Schedule the report decollating mission on all days of period i except the nth
day of period i from the beginning of the period.
LnPi,... Schedule the report decollating mission on the nth day of period i counting
backward from the last day of the period.
LnPi,... Schedule the report decollating mission on all days of period i except the nth
day of period i counting backward from the last day of the period.

General Information
Negative values take precedence over positive values when determining whether or
not a mission is scheduled on a certain date. If a negative value (that is, format n,
Dn, Ln, DnPi, or LnPi) in either the DAYS or WDAYS field prevents a mission
from being scheduled on a date, the mission is not scheduled on that date even if a
positive value (such as Ln) would otherwise result in the mission being scheduled on
that date.

A maximum of eight periodic values (of type DnPi, DnPi, LnPi, and LnPi) can be
designated in any desired order.

If periodic and non-periodic values are mixed when specifying parameter DAYS,
processing depends on the calendar type specified in parameter DCAL:

If a non-periodic calendar is specified in the DCAL parameter, only non-periodic

values in the DAYS parameter are processed; periodic values are ignored. In this
case, negative periodic values (such as DnPi, LnPi) are also ignored and do not
supersede other values.

If a periodic calendar is specified in the DCAL parameter, all periodic values and
the negative non-periodic value -n in the DAYS parameter are processed; all other
non-periodic values are ignored.

Chapter 3 Decollating Mission Parameters 441

DAYS: Basic Scheduling Parameter

D*Pi and D*P*, and L*Pi and L*P* are not permitted, because these values would
result in ordering the mission on no days in a period or no days in all periods, a
meaningless request.

Parameter MONTHS is ignored when periodic values are specified in parameter

DAYS or WDAYS.

Parameter DAYS cannot be used with parameters PDS, MINIMUM, and DATES.

Examples
The examples in this chapter are based on the following assumptions:

The current month is December 2001.

Working days are defined in calendar WORKDAYS, which contains the following
working days (indicated by Y) for December 2001.

---S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y

WDAYS are defined as working days beginning on Monday.

Periodic calendar PERIDAYS contains the following periodic definition for

December 2001. These examples assume that all other days of this calendar are
blank.

---S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
B C A A B B C A A B B C A A B B C A A B B

Start of the week is defined as Monday. Weeks start on the following dates in
December 2001: 3rd, 10th, 17th, 24th, and 31st.

At the end of each example, asterisks in a December 2001 calendar indicate the days
on which the mission is scheduled.

Example 1

Schedule the mission on the 17th day and the last day of the month.

DAYS 17,L1

442 CONTROL-D and CONTROL-V User Guide

 DAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 215 DAYS Parameter Example 1

Example 2

Schedule the mission on all working days of the month except the 6th day of the
month, and also schedule the mission on the 1st day of the month.

DAYS +1,-6
DCAL WORKDAYS

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 216 DAYS Parameter Example 2

Example 3

Schedule the mission on all working days of the month except the first and last
working days of the month, and except the 17th day of the month.

DAYS -D1,-17,-L1
DCAL WORKDAYS

Chapter 3 Decollating Mission Parameters 443

DAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 217 DAYS Parameter Example 3

Example 4

Schedule the mission on the 8th day of the month. If it is a non-working day, schedule
the mission on the closest preceding working day.

DAYS <8
DCAL WORKDAYS

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 218 DAYS Parameter Example 4

Example 5

Schedule the mission on the 1st day of period A, and on all days, except the 2nd day,
of period B. Do not schedule the mission on the 5th day of the month.

DAYS -5,D1PA,-D2PB
DCAL PERIDAYS

444 CONTROL-D and CONTROL-V User Guide

 DAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 219 DAYS Parameter Example 5

Example 6

Schedule the mission on each Monday and on the 1st day of the month.

DAYS 1
AND/OR OR
WDAYS 1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 220 DAYS Parameter Example 6

Example 7

Schedule the mission on the 3rd day of the month only if it is a Monday.

DAYS 3
AND/OR AND
WDAYS 1

Chapter 3 Decollating Mission Parameters 445

DAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 221 DAYS Parameter Example 7

Example 8

Schedule the mission on the last Monday of the month.

DAYS L1,L2,L3,L4,L5,L6,L7
AND/OR AND
WDAYS 1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 222 DAYS Parameter Example 8

Example 9

Schedule the mission on the 1st, 7th and 15th days of the month if they are both
Saturdays and working days. If the day of the month (1st, 7th, 15th) is not a Saturday,
do not schedule the mission. If the day of the month is a Saturday, but it is not a
working day, schedule the mission on the next working day.

DAYS 1,7,15
AND/OR AND
WDAYS 6
CONFCAL WORKDAYS
SHIFT >

446 CONTROL-D and CONTROL-V User Guide

 DAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 223 DAYS Parameter Example 9

Example 10

Schedule the mission to run on the first Friday after the 15th of the month.

DAYS 16,17,18,19,20,21,22
AND/OR AND
WDAYS 5

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 224 DAYS Parameter Example 10

Chapter 3 Decollating Mission Parameters 447

DESC: General Parameter

DESC: General Parameter

Report decollating mission description that is displayed in the Category List screen.

Figure 225 DESC Parameter Format

Optional. Parameter DESC specifies a text of 1 through 50 characters per line. When
you enter text in parameter DESC and press Enter, another DESC line is displayed. An
unlimited number of description lines can be specified.

General Information
Parameter DESC is informational. It does not affect mission processing. The
description is intended to let the user know the purpose of (or some other key
information about) the mission.

A report decollating mission description can be written in any language. It is used as

an internal help facility, assisting the user in controlling the report decollating
mission.

Example
Category DAILY is displayed in the Category List screen with the description
EMPLOYEE DAILY REPORTS FOR ALL DEPARTMENTS.

448 CONTROL-D and CONTROL-V User Guide

 DESC: General Parameter

Figure 226 DESC Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE DAILY REPORTS FOR ALL DEPARTMENTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 449

DO Statement: Decollating Parameter

DO Statement: Decollating Parameter

Action to perform if WHEN statement criteria are satisfied.

Figure 227 DO Parameter Format

Optional. Specify DO statements as follows:

Type the action keyword (such as COND) in the DO field and press Enter.

In many cases, subparameter fields are displayed. Fill in the subparameter values
and press Enter again.

After entering a DO statement, another DO line is automatically displayed. Multiple

DO statements can be specified.

The following are valid DO actions. Each is discussed individually in this chapter:

Table 206 DO Parameter Actions (part 1 of 2)

Action Description
DO BACKUP Specifies the backup missions to back up a report.
DO COND Adds and/or deletes prerequisite conditions.
DO CTBRULE Invokes a CONTROL-M/Analyzer rule.
DO INDEX Defines a main index and subindexes for a CDAM file.
DO LEVEL Specifies the level of a report page recipient.
DO MIGRATE Specifies a migration mission to move the report from DASD to another
storage media.
DO NAME Specifies the report name identified by a WHEN statement.
DO NOTOK Causes a report decollating mission to terminate NOTOK.
DO PRINT Specifies the printing mission to print the report.
DO REMARK Specifies a remark to be generated.
DO SET Assigns a value to a variable that can be used by other decollation
parameters.

450 CONTROL-D and CONTROL-V User Guide

 DO Statement: Decollating Parameter

Table 206 DO Parameter Actions (part 2 of 2)

Action Description
DO SHOUT Sends a message to a specified destination.
DO USER Specifies the recipient for a report page.

General Information
DO statements are generally paired with preceding WHEN statements (described
later in this chapter). Their implied relationship is:

IF WHEN statement criteria are satisfied,

THEN Perform all actions specified in the DO statements.

To delete unwanted DO statements, either delete the DO keyword and press Enter or
specify appropriate line editing commands in the Edit environment (described in
Appendix A, Editing Mission Definitions in the IOA Edit Environment).

Chapter 3 Decollating Mission Parameters 451

DO BACKUP: Decollating Parameter

DO BACKUP: Decollating Parameter

Specifies the names of the backup missions that backs up the sysout.

Figure 228 DO BACKUP Parameter Format

Optional. Type BACKUP in the DO field and press Enter. Fields are provided for one
to six backup mission names. One or more backup mission names of 1 through 8
characters must be specified.

General Information
Statement DO BACKUP specifies the name of the backup missions to be used for the
report.

A backup mission name usually represents the length of time to retain the backup
(such as BKP0031D).

Up to six different backup missions can be specified in one decollating mission. If

multiple backup missions are specified, the report is backed up by the specified
backup mission that is activated first. The report is not backed up twice by different
backup missions.

Example
Backup mission BKP0031D is used to perform the backup of the EMPLOYEES
REPORT.

452 CONTROL-D and CONTROL-V User Guide

 DO BACKUP: Decollating Parameter

Figure 229 DO BACKUP Parameter Example

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO BACKUP = BKP0031D
DO NAME = EMPLOYEES REPORT
DO USER = PRODCNTL LVL LINE COL -
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE 00002 COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO
WHEN LINE 00001 - 00001 COL 00001 - 00001 PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

The name of the backup mission is BKP0031D but the exact number of days the
backup is kept is specified in the backup mission definition. For more information,
see # OF DAYS TO KEEP: Mission Specific Parameter on page 648.

Chapter 3 Decollating Mission Parameters 453

DO COND: Decollating Parameter

DO COND: Decollating Parameter

Adds or deletes prerequisite conditions if the identifying string specified in the
accompanying WHEN statement is found.

NOTE
DO COND and OUT statements are similar, but not identical. The differences are outlined
below in OUT/DO COND Differences.

Figure 230 DO COND Parameter Format

Optional. Type COND in the DO field and press Enter. Fields are provided for the
subparameters described below.

A maximum of two prerequisite conditions can be specified in each DO COND line.

Upon specifying one or two prerequisite conditions in a line and pressing Enter, a
new line is opened for specifying additional DO COND statements.

Each DO COND statement consists of the following mandatory subparameters:

Table 207 DO COND Subparameters (part 1 of 2)

Subparameter Description
condition User-assigned, descriptive name of 1 through 20 characters used to
identify the condition.
Note: If CONTROL-M is installed, a condition name should not begin
with the | symbol and should not contain parentheses () because
these characters are used in defining Boolean logic for conditions.

454 CONTROL-D and CONTROL-V User Guide

 DO COND: Decollating Parameter

Table 207 DO COND Subparameters (part 2 of 2)

Subparameter Description
dateref 4-character date reference. Valid values are:

dateSpecific date (in either mmdd or ddmm format, depending

on the site standard).

STAT Static. Indicates that the condition (for example,

PRINTER-SET) is not date dependent.

ODAT Original scheduling date. Default.

PREV Previous date on which the mission should have been

scheduled, according to its basic scheduling criteria (or ODAT1 if
the mission is being forced).

NEXT Next scheduling date (or ODAT+1 for a forced mission).

**** Any scheduling date. Valid only with opt set to

$$$$ Any scheduling date. Valid only with opt set to

If a date reference is not specified, the value ODAT is automatically

inserted upon pressing Enter.
opt Indicates whether to add or delete the specified prerequisite
condition. Valid values are:

+ Add (create) the prerequisite condition.

- Delete the prerequisite condition.

General Information
When a DO COND statement is activated, the specified prerequisite conditions are
added to or deleted from the IOA Conditions file according to the specified opt value.

Prerequisite conditions are usually used to establish job and mission dependencies or
ensure manual intervention when required.

To establish mission-to-job dependency, define a prerequisite condition in an OUT or

DO COND statement in the job or mission that should run first, and in an IN
statement in the job or mission that should run afterwards.

The job or mission containing a prerequisite condition in its IN statement is not

submitted unless that prerequisite condition has been added manually or by a job or
mission containing an OUT or DO COND statement.

An OUT statement is used to add the prerequisite condition if the mission ends OK.

Chapter 3 Decollating Mission Parameters 455

DO COND: Decollating Parameter

Statement DO COND adds the prerequisite condition if the identifying string

specified in the accompanying WHEN statement is found.

If the IN prerequisite condition can only be satisfied by manual intervention (for

example, PRINTER-SET is set by the operator after the printer is ready), performance
of the required manual intervention before mission execution is ensured.

OUT and DO COND statements can also be used to delete prerequisite conditions. If
an IN prerequisite condition for a mission is not an IN prerequisite condition for any
other mission, you can use the missions OUT statement to delete the prerequisite
condition after the mission ends OK.

DO COND functions are performed after the functions of the OUT parameter.

If a prerequisite condition is added by the OUT parameter and deleted by the DO

COND parameter, the combined effect is the deletion of the prerequisite condition.

If a prerequisite condition is deleted by the OUT parameter and added by the DO

COND parameter, the combined effect is the addition of that prerequisite
condition.

(For more information, see the descriptions of parameters IN, OUT and WHEN later
in this chapter.)

The following are examples of prerequisite conditions:

OSS-READY
WEEKEND
JOB_PAYCALC_ENDED_OK
PRINTER_SET

All prerequisite conditions are associated with a date reference that is used to
distinguish between different executions of the same mission with different
scheduling dates. If, for example, a condition is being deleted, only the condition
matching the specified date is deleted. The same condition associated with a different
date is not deleted. When adding or deleting prerequisite conditions, the date
associated with the prerequisite condition can be a specific 4-character date or one of
the following symbolic dates:

Table 208 Symbolic Prerequisite Condition Dates (part 1 of 2)

Symbolic Date Description
STAT Adds or deletes a prerequisite condition with the date value STAT.
ODAT Adds or deletes the prerequisite condition with the original
scheduling date of the mission.
PREV Adds or deletes the prerequisite condition with the previous
scheduling date of the mission (or ODAT1 if the mission is forced).

456 CONTROL-D and CONTROL-V User Guide

 DO COND: Decollating Parameter

Table 208 Symbolic Prerequisite Condition Dates (part 2 of 2)

Symbolic Date Description
NEXT Adds or deletes the prerequisite condition with the next scheduling
date of the mission (or ODAT+1 if the mission is forced).
**** or $$$$ Valid only with an opt value of . Either of these values results in the
deletion of all matching prerequisite conditions regardless of date.

Prerequisite conditions created by statement DO COND can trigger the execution of

other jobs or missions.

Prerequisite conditions deleted by statement DO COND can prevent the execution of

jobs and missions whose IN statements require those prerequisite conditions.

If two or more DO COND statements are contradictory, statements performed earlier

are overridden by statements which are performed later.

For more information regarding prerequisite conditions, see Prerequisite Condition

Concept on page 70.

OUT/DO COND Differences

Statements OUT and DO COND have the following differences:

Statement OUT is applied only if the mission ends OK. DO COND statements are
associated with accompanying WHEN statements and are applied only if the
WHEN criteria are satisfied.

An OUT statement appears in each mission scheduling definition. No DO COND

statement appears unless specified. To specify a DO COND statement, type COND
in an empty DO field and press Enter.

DO COND statements are processed after OUT statements and can therefore
override OUT statements.

Use of %%JOBNAME String

When the string %%JOBNAME appears inside a DO COND prerequisite condition, it
is automatically replaced by the job name currently being processed by the report
decollating mission. The parameter is very useful for generic decollating missions. It
can be used to trigger decollating missions which do not wait for the job in queue, but
work on CDAM datasets.

Chapter 3 Decollating Mission Parameters 457

DO COND: Decollating Parameter

Example
Add the prerequisite condition ACC-DB-UPDATE-OK.

Figure 231 DO COND Parameter Example

----- CONTROL-D/V CATEGORY DAILY JOB PLUPDT02 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00002 - 00002 COL 00002 - 00040 PRINT REF NXT CT AND/OR A
STRING = UPDATE APPLICATION 2
WHEN LINE 00045 - 00060 COL 00025 - 00050 PRINT REF NXT CT AND/OR
STRING = ALL ACCOUNTS BALANCED
DO COND = ACC-DB-UPDATE-OK ODAT +
DO NAME = DB ACCOUNTING UPDATE
DO USER = ACCOUNTING LVL LINE COL -
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE 00001 - 00001 COL 00001 - 00001 PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

458 CONTROL-D and CONTROL-V User Guide

 DO CTBRULE: Decollating Parameter

DO CTBRULE: Decollating Parameter

Invokes a CONTROL-M/Analyzer rule during the processing of report pages.
Available only at sites utilizing CONTROL-M/Analyzer.

Figure 232 DO CTBRULE Parameter Format

Optional. Type CTBRULE in the DO field and press Enter. The following
subparameters are displayed:

Table 209 DO CTBRULE Subparameters

Subparameter Description
rule Name of the CONTROL-M/Analyzer rule that should be executed.
The CONTROL-M/Analyzer rule contains all balancing
specifications to be performed. The rule name can be 1 through 8
characters. Mandatory.
ARG Arguments that are passed to the CONTROL-M/Analyzer rule.
Separate multiple arguments by commas. A maximum of 45
characters can be specified. Optional.

General Information
When DO CTBRULE is specified, balancing is performed by the
CONTROL-M/Analyzer Runtime environment according to the specified rule
definition and using the specified arguments.

When CONTROL-V calls a CONTROL-M/Analyzer rule, CONTROL-M/Analyzer

system variable SYSOPT contains one of the values in Table 210, which represent the
stages of CONTROL-V processing.

Chapter 3 Decollating Mission Parameters 459

DO CTBRULE: Decollating Parameter

Table 210 CONTROL-M/Analyzer System Variable SYSOPT Values

Value Description
CTDFIRST CONTROL-V starts scanning the report pages. Report pages have
not yet been sent to CONTROL-M/Analyzer for processing.
CTDWORK Report pages that match CONTROL-V WHEN criteria are being sent
to, and processed by, CONTROL-M/Analyzer.
CTDLAST SYSOPT contains this value after all report pages have been
processed, only if that parameter DO TERMINAT has not been
specified during the CTDFIRST and CTDWORK stages.

Variable SYSOPT can be tested within the CONTROL-M/Analyzer rule definition to

determine if CONTROL-V invoked the CONTROL-M/Analyzer Runtime
environment.

When the CONTROL-M/Analyzer Runtime environment is invoked by

CONTROL-V (that is, CONTROL-M/Analyzer System variable SYSOPT is set to
CTDFIRST, CTDWORK or CTDLAST), CONTROL-M/Analyzer analyzes and
balances report pages. CONTROL-M/Analyzer can return information to
CONTROL-V by entering one of the following statements:

DO TERMINAT NOTOK: CONTROL-D responds as if CONTROL-D parameter

DO NOTOK was specified.

DO REMARK: The first 16 characters of the CONTROL-M/Analyzer remark are

used as the CONTROL-D remark.

For more information about invoking CONTROL-M/Analyzer rules from report

decollating mission definitions, see Interface to CONTROL-D in Chapter 10 of the
CONTROL-M/Analyzer User Guide.

Example
Invoke CONTROL-M/Analyzer rule INVBAL to check the Inventory report.

460 CONTROL-D and CONTROL-V User Guide

 DO CTBRULE: Decollating Parameter

Figure 233 DO CTBRULE Parameter Example

------CONTROL-D/V CATEGORY DAILY JOB DAYTASK -----------( R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
SHOUT WHEN NOTOK TO OPER2 URG R
MSG ==== REPORT DECOLLATION FOR REPORT1 ENDED NOT OK ====
SHOUT WHEN TO URG
MSG
===========================================================================
DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00003 - 00003 COL 00034 - 00050 PRINT REF NXT CT AND/OR
STRING = INVENTORY REPORT
DO USER = WAREHOUSE LVL LINE COL -
S N T SYNONYM = CONCAT =
DO USER = PRODUCTION LVL LINE COL -
S N T SYNONYM = CONCAT =
DO NAME = INVENTORY REPORT
DO PRINT = STD MUST =
DO BACKUP = BKP0007D
DO CTBRULE = INVBAL ARG ONORDER,200,ONHAND,500
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 11.33.28

Chapter 3 Decollating Mission Parameters 461

DO INDEX: Decollating Parameter

DO INDEX: Decollating Parameter

Defines a main index and optional subindexes for a CDAM file.

Figure 234 DO INDEX Parameter Format

Optional. Type INDEX in the DO field and press Enter.

INDEX Definition Formats

An index definition is in one of the following formats:

LINE (default)
VAR

A LINE format index definition consists of the following:

a column specification, which must be one of the following:

an absolute column range

a relative column range, defined by reference to the column identified by the
mandatory MASK value

462 CONTROL-D and CONTROL-V User Guide

 DO INDEX: Decollating Parameter

a specified line

an index type

A VAR format index definition consists of the following:

a specified variable
an index type

To change from the default LINE format to the VAR format, type %% in the LINE
field and press Enter. The VAR format screen is displayed.

To change from the VAR format to the LINE format, delete the contents of the VAR
field and press Enter. The LINE format screen is redisplayed.

DO INDEX Subparameters
The following subparameters are displayed:

Table 211 DO INDEX Subparameters (part 1 of 6)

Subparameter Description
main_index Name of a main index. One through 20 alphanumeric characters
including hyphen and underscore. Embedded blanks are not
permitted. Mandatory.

Specifying the reserved word DDNAMES produces a special index

described below under General Information.

Chapter 3 Decollating Mission Parameters 463

DO INDEX: Decollating Parameter

Table 211 DO INDEX Subparameters (part 2 of 6)

Subparameter Description
M Defines multi-value index. Optional. Valid values are:

M (Mask) - Create multi-value index from the one range

according to mask.

More than one index value will be created if more than one
substring matching the MASK is found in the specified range.
The relative INDEX COL parameter and MASK enclosed in
asterisks are mandatory.

A (And) - Define additional value range for the multi-value

index.

The AND statement will appear after INDEX, SUBINDEX, or

AND statements. The AND statement does not show R, G, and
RC subparameters.

If the relative INDEX COL parameter and MASK enclosed in

asterisks is used, and more the one substring matching the
MASK is found in the specified range, all of the substrings that
match the MASK will be extracted.

To delete an AND statement, type blank in the M field of

previous DO INDEX, SUBINDEX, or AND statement.

T (Tree) - Define additional range in value branch for multi-

value index with separate subindex values.

The first DO INDEX/SUBINDEX statement defines the value

range in base value branch of index tree. The additional DO
INDEX/SUBINDEX statements for the same index define the
value ranges in the additional value branch defined above in
base statement. The additional DO INDEX/SUBINDEX
statement doesn't show R, G and RC subparameters.

The low level values will be connected exactly to the higher level
values from the same tree branch.

The base and additional value ranges may be specified under

different ON/WHEN statements.

If the relative INDEX COL parameter and MASK enclosed in

asterisks is used, and more than one substring matching the
MASK is found in some specified range, all of the sub-strings
matching the MASK will be extracted.

Blank - Define regular index. Default.

464 CONTROL-D and CONTROL-V User Guide

 DO INDEX: Decollating Parameter

Table 211 DO INDEX Subparameters (part 3 of 6)

Subparameter Description
R Determines whether or not the main index and its subindexes
remain disk-resident. Optional. Valid values are:

Y (Yes) Indexes remain on disk when the report migrates.

Copies of indexes migrate with the CDAM file. Default for first
three main indexes (including their subindexes) created for each
report name.

N (No) Indexes migrate with the CDAM file. Default for

indexes created after the first three main indexes. Indexes
deleted from disk are accessible from the media to which they
migrated.
G Global indexes support. Valid values are:

Y Add the index values to Global Index DB2 tables during

decollation mission processing.

N Do not add the index values to Global Index DB2 tables. You
can add them by means of the CTVUPGBD utility. Default.
(index) LINE Used in the LINE format only.This field specifies the report line on
which the index value can occur.

To change to VAR format, type %% and press Enter.

The LINE subparameter can be in one of the following formats:

Record level Type a + or sign followed by a number from 000

to 99999 that indicates the position of the line containing the
index value relative to the line containing the mandatory mask
value. Mandatory. The index value and mask value must be on
the same page.

Page level Type a number from 001 through 99999 that

identifies the report line on which the index value can be found.
Optional. The default value is the line containing the WHEN
string. If a mask value is specified, this field can include a + or
sign as described above for a record level index.
Note: If the comparison operator in the STRING subparameter of the
WHEN parameter is set to .NE., do not use a blank value for the
LINE subparameter. This is because the .NE. setting indicates that a
specific line cannot be determined. For more details see Table 241 on
page 623.

Chapter 3 Decollating Mission Parameters 465

DO INDEX: Decollating Parameter

Table 211 DO INDEX Subparameters (part 4 of 6)

Subparameter Description
VAR Used in the VAR format only. The variable from which to extract the
index values.

Format: %%varname[(startpos,length)] where

varname is the name of the variable, comprised of 1 through 8

characters. Mandatory.

startpos is the starting position of the substring to be extracted

from the variable.

length is the length of the substring to be extracted from the

variable.

To change to LINE format, delete the contents of this field and press
Enter.
COL Used in the LINE format only. Identifies one of the following:

an absolute column range from which to extract the index values

a relative column and index value length from which to extract

the index values

The maximum number of columns that can be specified is 50.

The COL subparameter has two mandatory subparameters:

from_col The format of from_col depends on whether an

absolute or relative column range is required, as follows:
If an absolute column range is specified, from_col is a 5-digit
number from 00001 through 32768 that specifies the report
column in which the index value begins.
If a relative column range is specified, from_col is a + (plus) or
- (minus) sign followed by a 5-digit number from 00001 through
32768 that specifies the report column in which the index value
begins, by reference to the column in which the mandatory mask
value begins. BMC Software recommends that you enclose the
mask value between asterisks (*).

to_col The format of to_col depends on whether an absolute or

relative column range is required, as follows:
If an absolute column range is specified, to_col is a 5-digit
number from 00001 through 32768 that specifies the report
column in which the index value ends. to-col must be greater
than or equal to from-col.
If a relative column range is specified, to_col is a 5-digit
number from 00001 through 00050 that specifies the index value
length. Use only if from_col is a relative value.

466 CONTROL-D and CONTROL-V User Guide

 DO INDEX: Decollating Parameter

Table 211 DO INDEX Subparameters (part 5 of 6)

Subparameter Description
MASK Mandatory for record level index, and for index with relative column
value. Optional for a page-level index. 1 through 20 character mask
that must be matched to validate an index value and trigger
indexing. Valid wild card mask characters are:

* Zero to any number of characters

? Any single character
@ Any single letter (A-Z, a-z)
# Any single digit (0 - 9)
(mask) LINE A pair of 5-digit numbers from 00001 through 32768 that specifies
the report line range within which the string to compare with the
mask occurs.

For a record level index, this line range is mandatory and must
include more than one report line.

For a page level index, this line range is optional and its default
value is the line containing the WHEN string. Line ranges for the
index and mask can be different but must be on the same page.

For ON TRNCLASS or ON TRNDSN the first digit of the line

number is set according to the orientation. For more information see
Creating a Text Report from the Print Stream Report (Second
Temporary Decollation Definition) on page 813.
RC Index type. Optional. Specifies whether an index is page level,
continuous record level, or non-continuous record level. Valid
values are:

N (No) The index is page level. Default.

C (Continuous) The index is continuous record level.
Y (Yes) The index is non-continuous record level.
x The index is non-continuous record level with a maximum
number of x highlighted records, where x is a single digit from 1
through 9.

Chapter 3 Decollating Mission Parameters 467

DO INDEX: Decollating Parameter

Table 211 DO INDEX Subparameters (part 6 of 6)

Subparameter Description
SUBINDX One through 20-character subindex name. Optional. Each level 01
main index (except DDNAMES) can have hierarchical subindexes at
levels 02 through 10. A maximum of nine subindexes can be defined
for each main index. No level between the main index and the level
being specified can be skipped.

As the main index and each of the first eight subindexes are
specified, two additional lines are displayed for specifying a
subindex. Subindex parameters LINE, COL, VAR, MASK, LINE,
COL and RC are identical to the corresponding main index
parameters. Parameter R is not displayed. The disk-resident status of
each subindex is the same as the main index at the top of its
hierarchy.
LVL 2-digit hierarchical index level from 02 (highest subindex) through
10 (lowest subindex). Optional. Default is the next lower level
(greater number) in the hierarchy under the last previously specified
index. For information about hiding and displaying the Index Level
Display, see PATH Command on page 124.

General Information
Statement DO INDEX enables the user to specify:

a main index and optional subindexes for a CDAM file

report locations (line and column ranges) of index values
variable location (variable name) of index values
an index mask and report location of a string that must match the mask
whether the index is page level or record level
whether or not the indexes remain resident on disk when the report migrates

After a report is decollated, report sections can be retrieved by specifying index and
subindex values. Index values point to a section (one or more pages) of a report based
on one of the following:

a text string which occurs within a specified column range in a specified line
(range) on the first page of the section

the value of a variable that was set in other statements

Each DO INDEX statement defines a main index for the CDAM file selected by the
current WHEN block. A maximum of nine main indexes can be created per report. A
maximum of nine subindexes can be specified for each main index.

468 CONTROL-D and CONTROL-V User Guide

 DO INDEX: Decollating Parameter

The index hierarchy can be horizontal (with all subindexes at level 02), or vertical
(with each subindex at a different level), or any intermediate shape (such as those
illustrated in examples 1 and 2 below). A subindex cannot be specified before
specifying the chain of indexes above it in the hierarchy. As each index is specified,
specify all subindexes below it in the hierarchy before specifying a subindex at the
same or any higher level.

The presence of an indexable value on a page can optionally be validated by the

presence of a similarly defined mask value on the same page. Any page without an
indexable value is treated as a continuation of the previous pages in that section.

If the $MEMORY system variable is set to ABOVEBAR, CONTROL-D will use

storage above bar instead of virtual storage for internal index structures.

Page Level and Record Level Indexes

An index can be implemented at page level or record level. A page level index has
one value per page. A record level index can have a value for every line on a page. In
either case, when retrieving by an index value, the entire page is viewed. However, if
a page is retrieved using a record level index value, report lines pointed to by that
value are displayed in a different color or highlighted.

Combinations of page level and record level indexes can be specified in an index
path. However, a subindex cannot be page level if any index above it in the index
hierarchy is record level.

For more information about indexes, see Report Indexes on page 65 and Index
Design on page 821.

Main Indexes

When RC is set to C (continuous record level) for a main index, header (title) lines
after a page break inherit the last previous value found for the index.

When RC is set to Y (non-continuous record level) for a main index, the line range of
the index value mask can be used to prevent header lines from inheriting the last
found value for the index. If header lines are excluded in this way, the absence of an
indexable value in those lines does not cause the main index to automatically point to
every following page. This feature is illustrated by Example 4 on page 476.

Subindexes

When RC is set to C for a subindex, unindexed records inherit the last previous
value found for this subindex even after a change in the value of a higher level index.
For more information, see Example 3 on page 474.

Chapter 3 Decollating Mission Parameters 469

DO INDEX: Decollating Parameter

When RC is set to Y for a subindex, unindexed records are not pointed to by any
value in this subindex until the next valid subindex value is found. For more
information, see Example 3 on page 474.

When RC is set to x for a subindex, where x is a single digit from 1 through 9,

unindexed records are not pointed to by any value in this subindex until the next
valid subindex value is found. The number of highlighted indexed records is limited
by the value of x.

Main Index DDNAMES

Main index name DDNAMES produces a special index with one value for each
DD statement. Each value is formed by concatenating the 4-digit sequential number
of the sysout in the job and the 8-character names of the

DD statement
PGMSTEP
PROCSTEP

If any exist in the JCL of the job decollated by the decollating mission.

Separate indexes are produced for each CDAM file. By default, separate CDAM files
are produced for each JES data set. Index DDNAMES is only appropriate for reports
decollated by a mission with parameter ALLOCOPT=JOBSDSN1 or ONEDSN
specified in the ON CLASS statement PRINT/CDAM PARMS field. If a DDNAMES
index is created for other reports, it only contains a single value pointing to the one
data set in the CDAM file. For more information about parameter ALLOCOPT, see
CDAM Control Parameters on page 763.

Main Index JOBNAME_DDNAMES

Enter DO INDEX=JOBNAME_DDNAMES to create a main index with the name
JOBNAME with a subindex of the DDNAMES. The main index has a single value
comprised of the fixed length fields listed below, separated by a blank. The same
format is also used by the CTVJAR utility. For further information, see the CTVJAR
utility in the INCONTROL for z/OS Utilities Guide.

Table 212 Values for JOBNAME in DO INDEX=JOBNAME_DDNAMES Expression

(part 1 of 2)
Name Description
JOBNAME Name of the job
JOBID ID of the job
SMFID SMF ID of the system in which the job ran
COMP-CODE Completion code of the job

470 CONTROL-D and CONTROL-V User Guide

 DO INDEX: Decollating Parameter

Table 212 Values for JOBNAME in DO INDEX=JOBNAME_DDNAMES Expression

(part 2 of 2)
Name Description
DATE Date of the job
START-TIME Start time of the job
END-TIME End time of the job

This index structure ensures unified access to the reports (before and after
consolidation).

Multi-value indexes
You can define a multi-value index that contains more than one index value in an
index within

the same page in a page level index

the same line in a record level index

A user can access an indexed page or line of a report using any of the multi-values.

The line of the report which contains several record level index values is highlighted,
regardless of the value which is used for viewing.

For continued page or record level indexes, the page or line which has no index value
is indexed by each of the multi-values of the previous page or line.

The M (multiple) subparameter is used to define the method of creation of a multi-

value index.

Multi-value index from one range

To create a multi-value index from one range according to a mask, enter M=M
(Mask). For more information refer to Example 7 on page 445.

More than one index or subindex value is created if more than one substring
matching the MASK is found in the specified range. The relative INDEX COL
parameter and MASK enclosed in asterisks are mandatory. The mask validation
continues even if the appropriate value is found in the COL range.

Multi-value index from additional value ranges

To define additional value ranges for the multi-value index or subindex, specify M=A
(And). For more information, refer to Example 8 on page 446.

Chapter 3 Decollating Mission Parameters 471

DO INDEX: Decollating Parameter

The AND additional statements will appear after INDEX, SUBINDEX, or AND
statements to define an additional range. It is possible to define one or more
additional value ranges for the same index using M=A in the AND statement.

The index values are extracted from all INDEX or SUBINDEX ranges but all the
subindex values defined under such statements are connected to all higher level
values.

Multi-value index with separate subindex values

To define additional ranges in the value branch for the multi-value index with
separate subindex values, specify M=T (Tree). For more information, refer to
Example 9 on page 446.

The M=T parameter in INDEX or SUBINDEX statements defines the base full multi-
value index tree if it appears the first time for the specific index and subindex in the
decollation mission. The other M=T parameter for the same index on the same level
defines additional value ranges connected to additional value branches. Low level
values will be connected exactly to the higher level values from the same tree branch.

The base value branch may be combined with other regular indexes. The additional
value branch should contain a part or all of the base branch indexes but shouldn't
contain any regular index.

Examples

Example 1

This example illustrates a moderately deep and narrow index hierarchy.

Index Level
01 main
|
02 1
/ \
03 2 5
/ / \
04 3 6 7
| |
05 4 8

To create this hierarchy, the user defines the following DO INDEX/SUBINDX

statements. The Index Level Display is generated automatically as each path is
completed.

472 CONTROL-D and CONTROL-V User Guide

 DO INDEX: Decollating Parameter

Figure 235 DO INDEX Parameter Example 1

----- CONTROL-D/V CATEGORY NDX11232 JOB NDXTST1 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-------------------------------------------------------------------------------+
===========================================================================
DO INDEX = MAIN M R G LINE 00001 COL 00073 - 00077
MASK = RC N LINE - COL -
02 SUBINDX = INDEX_1 M LVL 02 LINE 00001 COL 00007 - 00025
MASK = RC N LINE - COL -
03 SUBINDX = INDEX_2 M LVL 03 LINE 00000 COL 00007 - 00015
MASK = RC Y LINE - COL -
04 SUBINDX = INDEX_3 M LVL 04 LINE 00000 COL 00017 - 00030
MASK = RC Y LINE - COL -
05 SUBINDX = INDEX_4 M LVL 05 LINE 00000 COL 00032 - 00040
MASK = RC Y LINE - COL -
03 SUBINDX = INDEX_5 M LVL 03 LINE 00002 COL 00027 - 00045
MASK = RC Y LINE - COL -
04 SUBINDX = INDEX_6 M LVL 04 LINE 00000 COL 00047 - 00055
MASK = RC N LINE - COL -
04 SUBINDX = INDEX_7 M LVL 04 LINE 00000 COL 00057 - 00070
MASK = RC N LINE - COL -
05 SUBINDX = INDEX_8 M LVL 05 LINE 00000 COL 00072 - 00080
MASK = RC N LINE - COL -
SUBINDX = M LVL LINE COL -
MASK = RC Y LINE - COL -
============================================================================
INDEX LEVEL DISPLAY
MAIN / INDEX_1 / INDEX_2 / INDEX_3 / INDEX_4
MAIN / INDEX_1 / INDEX_5 / INDEX_6
MAIN / INDEX_1 / INDEX_5 / INDEX_7 / INDEX_8
============================================================================
======= >>>>>>>>> END OF JOB/REPORT PARAMETERS FOR THIS CATEGORY <<<<<<< ====
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH, CAPS 08.55.42

If subindexes 5, 6, 7 and 8 had been specified immediately after subindex 2, the user
could blank out the specification of subindex 2, re-specify it at level 03 after subindex
8, and then specify subindexes 3 and 4.

Example 2

This example illustrates a moderately shallow and broad index hierarchy.

Index Level
01 main
/ \
02 1 5
/ \ / \
03 2 3 4 6 7 8

To create this hierarchy, the user defines the following DO INDEX/SUBINDX

statements. The Index Level Display is automatically generated as each index path is
completed.

Chapter 3 Decollating Mission Parameters 473

DO INDEX: Decollating Parameter

Figure 236 DO INDEX Parameter Example 2

----- CONTROL-D/V CATEGORY NDX126 JOB NDXTST2 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-------------------------------------------------------------------------------+
============================================================================
DO INDEX = MAIN M R G LINE 00001 COL 00004 - 00005
MASK = RC N LINE - COL -
02 SUBINDX = INDEX_1 M LVL 02 LINE 00001 COL 00007 - 00025
MASK = RC N LINE - COL -
03 SUBINDX = INDEX_2 M LVL 03 LINE 00001 COL 00027 - 00055
MASK = RC N LINE - COL -
03 SUBINDX = INDEX_3 M LVL 03 LINE 00001 COL 00057 - 00060
MASK = RC N LINE - COL -
03 SUBINDX = INDEX_4 M LVL 03 LINE 00002 COL 00004 - 00023
MASK = RC N LINE - COL -
02 SUBINDX = INDEX_5 m LVL 02 LINE 00002 COL 00025 - 00039
MASK = RC N LINE - COL -
03 SUBINDX = INDEX_6 M LVL 03 LINE 00002 COL 00041 - 00060
MASK = RC N LINE - COL -
03 SUBINDX = INDEX_7 M LVL 03 LINE 00003 COL 00004 - 00015
MASK = RC N LINE - COL -
03 SUBINDX = INDEX_8 M LVL 03 LINE 00003 COL 00017 - 00018
MASK = RC N LINE - COL -
============================================================================
INDEX LEVEL DISPLAY
MAIN / INDEX_1 / INDEX_2
MAIN / INDEX_1 / INDEX_3
MAIN / INDEX_1 / INDEX_4
MAIN / INDEX_5 / INDEX_6
MAIN / INDEX_5 / INDEX_7
MAIN / INDEX_5 / INDEX_8
============================================================================
======= >>>>>>>>> END OF JOB/REPORT PARAMETERS FOR THIS CATEGORY <<<<<<< =====
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 16.15.28

If any index is deleted by erasing (blanking out) its specification, its subindexes are
automatically deleted. For example, deleting subindex 5 automatically deletes
subindexes 6, 7 and 8 in both examples above.

For an example of subindex specification using realistic index names, see PATH
Command on page 124.

Example 3

This example illustrates the usage of page level, record level, and continuous record
level indexes.

The decollation mission below decollates an inventory report sorted by a warehouse

identifier (in columns 16-19 of line 4), and then by part number (in columns 2-12 of
any line). A new report page occurs whenever the previous page is full or the
warehouse identifier changes.

Indexed fields of the report to be decollated in this example look like this:

474 CONTROL-D and CONTROL-V User Guide

 DO INDEX: Decollating Parameter

WAREHOUSE WH01
1111-111-11 DESCRIPTION OF PART 11
2222-222-22 DESCRIPTION OF PART 22
WAREHOUSE WH02
2222-222-22 DESCRIPTION OF PART 22
3333-333-33 DESCRIPTION OF PART 33

In the WAREHOUSE / ITEM-NUM / ITEM-DESC path, main index WAREHOUSE

is specified as page level (RC=N). Subindexes ITEM-NUM and ITEM-DESC are
specified as record level non-continuous (RC=Y). Any line (record) which does not
have a value for these subindexes does not inherit the value of a prior line.

In this example, the index hierarchy whose main index is WAREHOUSE contains the
following values:

WAREHOUSE ITEM-NUM ITEM-DESC

WH01 1111-111-11 DESCRIPTION OF PART 11
2222-222-22 DESCRIPTION OF PART 22
WH02 2222-222-22 DESCRIPTION OF PART 22
3333-333-33 DESCRIPTION OF PART 33

The value WHO2 2222-222-22 points to line 2222-222-22 DESCRIPTION OF PART 22.
If index ITEM-NUM had been specified as RC=C (continuous), then this value would
point to two lines:

WAREHOUSE WH02
2222-222-22 DESCRIPTION OF PART 22

In the ITEM-NUM / WAREHOUSE path, subindex WAREHOUSE is specified as

continuous (RC=C). Therefore, the last identified WAREHOUSE value is associated
with each part number even though the WAREHOUSE value only occurs once prior
to the records for all the parts which are located in that warehouse. Main index
ITEM-NUM is specified as record-level (RC=Y). Records which contain only a
WAREHOUSE value does not inherit the ITEM-NUM value from the previous
record.

In this example, the index hierarchy whose main index is ITEM-NUM contains the
following values:

ITEM-NUM WAREHOUSE
1111-111-11 WH01
2222-222-22 WH01
2222-222-22 WH02
3333-333-33 WH02

Chapter 3 Decollating Mission Parameters 475

DO INDEX: Decollating Parameter

Figure 237 DO INDEX Parameter Example 3

----- CONTROL-D/V CATEGORY DAILY JOB PARTLST ---------- (R.S)
COMMAND ===> SCROLL===> CRSR
+---------------------------------------------------------------------------+
| CATEGORY DAILY JOBNAME PARTLST GENERIC MONITOR 1 |
| ========================================================================= |
| DEF COPIES 01 LVL USER INVTDPT DEST MAX COPIES |
| ========================================================================= |
| ON CLASS = S EXTWTR DEST FORM |
| PRT COPIES LVL USER DEST MAX COPIES |
| PRINT/CDAM PARMS = |
| WHEN LINE 00003 - 00003 COL 00034 - 00050 PRINT REF NXT CT AND/OR |
| STRING = INVENTORY REPORT |
| DO USER = ACCTG LVL LINE COL - |
| S N T SYNONYM = CONCAT = |
| DO NAME = INVENTORY REPORT |
| DO INDEX = WAREHOUSE M R G LINE +00000 COL 00016 - 00019|
| MASK = WAREHOUSE RC N LINE 00004 - 00004 COL 00002 - 00010|
| 02 SUBINDX = ITEM-NUM M LVL 02 LINE +00000 COL 00002 - 00012|
| MASK = ####-###-## RC Y LINE 00001 - 00200 COL 00002 - 00012|
| 03 SUBINDX = ITEM-DESC M LVL 03 LINE +00000 COL 00015 - 00035|
| MASK = * RC Y LINE 00001 - 00200 COL 00002 - 00012|
| SUBINDX = M LVL LINE COL - |
| MASK = RC LINE - COL - |
| ========================================================================= |
| INDEX LEVEL DISPLAY |
| WAREHOUSE / ITEM-NUM |
| WAREHOUSE / ITEM-DESC |
| ========================================================================= |
| DO INDEX = ITEM-DESC M R G LINE +00000 COL 00015 - 00035|
| MASK = ####-###-## RC N LINE 00001 - 00200 COL 00002 - 00012|
| 02 SUBINDX = WAREHOUSE M LVL 02 LINE +00000 COL 00016 - 00019|
| MASK = WAREHOUSE RC N LINE 00001 - 00200 COL 00002 - 00012|
| MASK = WAREHOUSE RC N LINE 00004 - 00004 COL 00002 - 00010|
| SUBINDX = M LVL LINE COL - |
| MASK = RC LINE- COL - |
| ==========================================================================|
| INDEX LEVEL DISPLAY |
| ITEM-DESC / WAREHOUSE |
| ==========================================================================|
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 11.29.29

Example 4

If a main index is specified as record level (RC=Y) and the report has header lines, the
absence of indexable values in the header lines could cause the last found value for
that index to improperly point to the next following page. This can be avoided by
excluding the header lines from the line range of the index value mask.

In this example, every report page has 3 title lines followed by 57 data lines. The main
index is record level (RC=Y). Enter LINE=+000 and specify a line range of 004-060 for
that main indexs value mask.

If a value for the main index is found on the first data line of the current page (line
004), the page range pointed to by the last previously found value for that index does
not include the current page because values for that index are not extracted from the
first 3 lines of each page.

476 CONTROL-D and CONTROL-V User Guide

 DO INDEX: Decollating Parameter

Example 5

This example illustrates the use of a DO INDEX statement with relative column and
line values. As a result of the setting of the MASK subparameter, the index value for
the report is extracted from the 10 characters that follow the NAME= string after this
string is found in lines 1 through 5 and columns 11 through 30.

Figure 238 DO INDEX Parameter Example 5

----- CONTROL-D/V CATEGORY NDX11232 JOB NDXTST1 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DO INDEX = NAME M R G LINE +00000 COL +0005 - 00010
MASK = *NAME=* RC N LINE 00001 - 00005 COL 00011 - 00030

Example 6

This example illustrates the use of a DO INDEX statement in VAR format to extract
an index value from the %%BANK variable. The previous DO SET statement sets the
variable value as a concatenation of two strings that are in two different lines of the
report.

Figure 239 DO INDEX Parameter Example 6

----- CONTROL-D/V CATEGORY NDX11232 JOB NDXTST1 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DO SET = %%BANK =* LINE 00001 COL 00001 - 00005 C Y CS
DO = * LINE 00002 COL 00001 - 00005 C CS
DO INDEX = BANK R G VAR %%BANK(1,10)
MASK = RC N LINE - COL -

Example 7

This example shows how to create a multi-value index from one range according to a
mask. The decollated indexing report appears as follows:

Figure 240 DO INDEX Parameter Example 7

1 TRANSFER REPORT
from warehouse NO: 1001 (NEW YORK) to warehouse NO: 1002 (CHICAGO)
ITEM NO. 1233-781-20 (A) 1233-781-21 1233-781-22 1233-781-23 (A)
1233-781-24 1233-781-25 1233-781-26 1233-781-27 (A) 1233-781-28

The decollation mission below shows the definition of the WAREHOUSE page level
index and the ITEM-NUM record level index on the page. Two values (1001 and 1002)
of WAREHOUSE and 9 values (from 1233-781-20 until 1233-781-28) of ITEM-NUM
will be assigned for this page. Both values of ITEM-NUM are connected to both
values of WAREHOUSE.

Chapter 3 Decollating Mission Parameters 477

DO INDEX: Decollating Parameter

DO INDEX = WAREHOUSE M M R _ G _ LINE +00000 COL +0004 - 00004

MASK = *NO: ####* RC N LINE 00002 - 00002 COL 00002 - 00070
02 SUBINDX = ITEM-NUM M M LVL 02 LINE +00000 COL +0000 - 00011
MASK = *####-###-##* RC Y LINE 00003 - 00060 COL 00003 - 00070

Example 8

This example shows how to create a multi-value index from additional value ranges.
The decollated indexing report appears as follows:

Figure 241 DO INDEX Parameter Example 8

1 REPORT: TRANSFER
FROM 1001 TO 1002
TRANSFERRED ITEMS:
1233-781-20
1233-781-21

The two decollation missions below show the definition of the WAREHOUSE page
level index and the ITEM-NUM record level index on the page. Two values (1001 and
1002) of WAREHOUSE and two values (1233-781-21 and 1233-781-22) of ITEM-NUM
are assigned for this page. Both values of ITEM-NUM will be connected to both
values of WAREHOUSE.

The WAREHOUSE is defined as a main index in the decollation mission below.

DO INDEX = WAREHOUSE M A R _ G _ LINE 00002 COL 00008 - 00011

MASK = RC N LINE - COL -
AND M _ LINE 00002 COL 00016 - 00019
MASK = LINE - COL -
02 SUBINDX = ITEM-NUM M _ LVL 02 LINE +00000 COL 00003 - 00013
MASK = ####-###-## RC Y LINE 00004 - 00060 COL 00003 - 00013

The WAREHOUSE is defined as a subindex of the REPORT main index in the

decollation mission below.

DO INDEX = REPORT M _ R _ G _ LINE 00001 COL 00011 - 00020

MASK = RC N LINE - COL -
02 SUBINDX = WAREHOUSE M A LVL 02 LINE 00002 COL 00008 - 00011
MASK = RC N LINE - COL -
AND M _ LINE 00002 COL 00016 - 00019
MASK = LINE - COL -
02 SUBINDX = ITEM-NUM M _ LINE +00000 COL 00003 - 00013
MASK = ####-###-## RC Y LINE 00004 - 00060 COL 00003 - 00013

478 CONTROL-D and CONTROL-V User Guide

 DO INDEX: Decollating Parameter

Example 9

This example shows how to create a multi-value index with separate subindex values.
The decollated indexing report appears as follows:

Figure 242 DO INDEX Parameter Example 9

1 INVENTORY REPORT : INVENTORY REPORT
WAREHOUSE NO: 1001 : WAREHOUSE NO: 1002
SHELF QNTY QNTY QNTY : SHELF QNTY QNTY QNTY
ITEM NO. LIFE UNIT AVAIL ORDER : ITEM NO. LIFE UNIT AVAIL ORDER
----------- ----- ---- ------- ------- : ----------- ----- ---- ------- -------
1233-781-21 NONE KG 100.00 250.00 : 1233-781-31 NONE KG 100.00 250.00
1233-781-22 NONE KG 500.00 500.00 : 1233-781-32 NONE KG 100.00 100.00

The two decollation missions below show the definition of the WAREHOUSE page
level index and the ITEM-NUM record level index on the page. Two values (1001 and
1002) of WAREHOUSE and four values (1233-781-21, 1233-781-31, 1233-781-22 and
1233-781-32) of ITEM-NUM will be assigned for this page. The two values of ITEM-
NUM from the left part of the report (1233-781-21 and 1233-781-22) are connected to
value 1001 of WAREHOUSE index, but two values from the right part (1233-781-31
and 1233-781-32) are connected to value 1002.

The WAREHOUSE is defined as main index in the decollation mission below.

DO INDEX = WAREHOUSE M T R _ G _ LINE 00002 COL 00017 - 00020

MASK = RC N LINE - COL -
02 SUBINDX = ITEM-NUM M T LVL 02 LINE +00000 COL 00003 - 00013
MASK = ####-###-## RC Y LINE 00005 - 00007 COL 00003 - 00013
DO INDEX = WAREHOUSE M T LINE 00002 COL 00067 - 00080
MASK = LINE - COL -
02 SUBINDX = ITEM-NUM M T LVL 02 LINE +00000 COL 00053 - 00063
MASK = ####-###-## LINE 00005 - 00007 COL 00053 - 00063

The WAREHOUSE is defined as a subindex of the REPORT main index in the

decollation mission below.

DO INDEX = REPORT M _ R _ G _ LINE 00001 COL 00020 - 00040

MASK = RC N LINE - COL -
02 SUBINDX = WAREHOUSE M T LVL 02 LINE 00002 COL 00017 - 00020
MASK = RC N LINE - COL -
03 SUBINDX = ITEM-NUM M T LVL 03 LINE +00000 COL 00003 - 00013
MASK = ####-###-## RC Y LINE 00005 - 00007 COL 00003 - 00013
02 SUBINDX = WAREHOUSE M T LVL 02 LINE 00000 COL 00067 - 00080
MASK = LINE - COL -
03 SUBINDX = ITEM-NUM M T LVL 03 LINE +00000 COL 00053 - 00063
MASK = ####-###-## LINE 00005 - 00007 COL 00053 - 00063

Chapter 3 Decollating Mission Parameters 479

DO LEVEL: Decollating Parameter

DO LEVEL: Decollating Parameter

Specifies the level and/or name of the user to whom the page identified in the WHEN
statement is sent.

Figure 243 DO LEVEL Parameter Format

Optional.

NOTE
The DO LEVEL parameter functions in the same way as parameter DO USER. In future
versions, DO LEVEL serves additional functions. It is recommended not to use DO LEVEL at
this stage.

480 CONTROL-D and CONTROL-V User Guide

 DO MIGRATE: Decollating Parameter

DO MIGRATE: Decollating Parameter

Specifies the name of the migration mission that copies this report from disk to
another storage media and then control the storage location of the report.

Figure 244 DO MIGRATE Parameter Format

Optional. Type MIGRATE in the DO field and press Enter. A field for the migration
mission name is provided. A migration mission name of 1 through 8 characters must
be specified.

General Information
A migration mission defines the migration path (from media to media) along which
the report migrates during its entire life.

Migration missions can be specified on any basis that is meaningful at your site. For
example, separate migration missions may be designated for:

Various retention periods (MIG0007YR, MIG30MON)

Various storage patterns (MIGISFTK, MIGCART)
Various report categories (MIGSALES, MIGPARTS)
Various access frequencies (MIGHEAVY, MIGLIGHT)
Reports that migrate one time only (MIGONCE)
A combination of retention period and category (MIGTAX7Y, MIG10YW2)

NOTE
Only one migration mission name should be specified for each report file (CDAM file). If more
than one migration mission is specified in the decollation definition, a report file is migrated
by the first migration mission whose name is encountered in the decollation process. If the
decollation process detects more than one migration mission name, a warning message is
issued to the IOA Log file and the decollation process terminates with a status of ENDED OK
WITH WARNINGS.

Chapter 3 Decollating Mission Parameters 481

DO MIGRATE: Decollating Parameter

For information about the migration process, see the CONTROL-D and CONTROL-V
chapter in the INCONTROL for z/OS Administrator Guide. For information about
migrated CDAM data sets, see Migrated CDAM Datasets on page 785.

Example
Migration mission MIGMIS is used to perform the migration of the EMPLOYEES
REPORT.

Figure 245 DO MIGRATE Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO MIGRATE = MIGMIS
DO NAME = EMPLOYEES REPORT
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE 00002 COL 00064 - 07004
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

482 CONTROL-D and CONTROL-V User Guide

 DO NAME: Decollating Parameter

DO NAME: Decollating Parameter

Specifies the name of the report identified by the WHEN statement.

Figure 246 DO NAME Parameter Format

NOTE
If the DO NAME statement is not specified, the default value is the report name for the last
previous page that was decollated or NONAME for the first page.

Optional. Type NAME in the DO field and press Enter. The following subparameters
are displayed:

Table 213 DO NAME Subparameters (part 1 of 2)

Subparameter Description
report_name Any text of 1 through 50 characters or * (asterisk) can be specified.
Mandatory.
LINE Line containing the report name.

A 5-digit number from 00001 through 32768. Leading zeros must be

supplied. The parameter is optional and can only be specified when
NAME is set to *.

If NAME is set to * and LINE is blank, the name is taken from the
line containing the WHEN string.

For ON TRNCLASS or ON TRNDSN the first digit of the line

number is set according to the orientation. For more information
see Creating a Text Report from the Print Stream Report (Second
Temporary Decollation Definition) on page 813.
Note: If the comparison operator in the STRING subparameter of the
WHEN parameter is set to .NE., do not use a blank value for the LINE
subparameter. This is because the .NE. setting indicates that a specific
line cannot be determined. For more details see the description of the
STRING field in a WHEN statement in Table 241 on page 623.

Chapter 3 Decollating Mission Parameters 483

DO NAME: Decollating Parameter

Table 213 DO NAME Subparameters (part 2 of 2)

Subparameter Description
COL Column range for the report name, comprised of:

col_from A 5-digit number from 00001 through 32768. Leading

zeros must be supplied. col_from is mandatory when NAME=*.

col_until A 5-digit number from 00001 through 32768 that must

be greater than or equal to col_from. Leading zeros must be
supplied. col_until is mandatory when NAME is set to *.

General Information
Statement DO NAME specifies either the report name or the line and column range
on the report page where the report name can be found. Later, the report name can be
used as a key for retrieving the report by the recipients or for sorting multiple reports
within a printing mission.

An asterisk should be entered if the report name is to be found on the report page; the
appropriate line and column references are then specified. IF DO NAME is set to *
and a report page has blanks in the from-until COL range, the report name for that
report page is set to NONAME.

Parameter LINE is optional. If it is omitted, the line in which the WHEN string was
found is used.

The report name specified is used for all pages until a new DO NAME is activated.
The same user cannot receive the same report page more than once, even under
different report names.

The report name field can be set to special values (described below) which begin with
%%.

To define the report name extracted from report content, do the following:

1 In the report_name field, type * (asterisk), and press Enter. The LINE and COL fields
are displayed. The length of the report_name field is reduced to twenty characters.

2 Enter the line and column numbers for the report field you want to extract.

NOTE
To switch back to the literal in the report_name field, replace the * in the report_name field
with any character other than a blank or * (asterisk), and press Enter. The LINE and COL
fields are hidden, and the length of the report_name field is restored to its default.

484 CONTROL-D and CONTROL-V User Guide

 DO NAME: Decollating Parameter

%%EXTWTR
The report name can be retrieved from the External Writer name. The format is

DO NAME = %%EXTWTR[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

Example

ON CLASS ABC EXTWTR $* . . .

DO NAME = %%EXTWTR(5,3)

NOTE
$* in ON CLASS parameter EXTWTR is a mask resulting in decollation of all outputs with a
writer name starting with $.

%%JOBNAME
The report name can be retrieved from the name of the job which produced the
output. Format:

DO NAME=%%JOBNAME[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

This option is useful for generic processing.

%%USERID
The report name can be retrieved from parameter USER in the job statement. Format:

DO NAME=%%USERID[(startpos,length)]

Chapter 3 Decollating Mission Parameters 485

DO NAME: Decollating Parameter

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

%%DDNAME
The report name can be extracted from the ddname of the JCL statement which
references the file to be decollated. Format of this statement is:

DO NAME=%%DDNAME[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

(1,8) extracts the entire DD name.

%%FILE
This statement can be used to generate a unique number for the file that is to be
decollated. Format of this statement is

DO NAME=%%FILE[(startpos,length)]

where

startpos is the first digit to extract from the unique 5-digit file number
length is the number of digits to extract

(3,3) extracts the last 3 digits of the 5-digit number.

In situations where multiple report outputs may be created by DD statements with

the same DD name, this statement is useful to ensure that each file to be decollated
has a separate entry in the Active Reports file.

%%DSNLLQ
This report name can also be extracted from the low level qualifier of the data set
name of the file to be decollated. The format is:

DO NAME=%%DSNLLQ[(startpos,length)]

486 CONTROL-D and CONTROL-V User Guide

 DO NAME: Decollating Parameter

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

%%CONTNAME
If a report name is not defined for this report page, the report name for the previous
page can be extracted and assigned to this page. Format of this statement is:

DO NAME=%%CONTNAME

Name Generation by Concatenation

It is possible to generate a report name by concatenating strings which appear in
different places in the report page and predefined strings.

The report name can be generated by using multiple DO NAME statements. Consider
the following examples:

Example 1

DO NAME=* LINE 00001 COL 00051 - 00061

DO NAME=*+*P LINE 00004 COL 00026 - 00029

The report name is composed from the contents of line 4 column 26-29 followed by
the contents of line 1 column 51-61. The string +*P translates into the name identified
by the previous DO NAME statement.

Example 2

DO NAME=*-TWO- LINE 00001 COL 00051 - 00061

DO NAME=*P+* LINE 00004 COL 00026 - 00029

The report name is composed from the contents of line 1 columns 51-61 followed by
the string TWO followed by the contents of line 4 columns 26-29. The string *P+
translates into the name identified by the previous DO NAME statement.

Only one + can appear in each DO NAME statement. The combination DO

NAME=*+*P+ ... is not valid.

Chapter 3 Decollating Mission Parameters 487

DO NAME: Decollating Parameter

Example 3

DO NAME=*P+ABC

The report name consists of the name identified by the previous DO NAME
statement concatenated with the string ABC.

Example 4

The report name is EMPLOYEES REPORT.

Figure 247 DO NAME Parameter, Name Generation by Concatenation Example 4

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 000461 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE 00001 - 00001 COL 00001 - 00001 PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

488 CONTROL-D and CONTROL-V User Guide

 DO NAME: Decollating Parameter

Example 5

The report name is extracted from columns 10 to 25 in line 5 of the report.

Figure 248 DO NAME Parameter, Name Generation by Concatenation Example 5

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = * LINE 00005 COL 00010 - 00070
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE 00001 - 00001 COL 00001 - 00001 PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Chapter 3 Decollating Mission Parameters 489

DO NOTOK: Decollating Parameter

DO NOTOK: Decollating Parameter

Sets the termination status of the report decollating mission to NOTOK when the
identifying string specified in the WHEN statement is found.

Figure 249 DO NOTOK Parameter Format

Optional. Type NOTOK in the DO field and press Enter. DO NOTOK has no
subparameters.

General Information
When DO NOTOK is specified, the report decollating mission terminates with
NOTOK status, even if the job actually decollated successfully. Therefore, none of the
jobs reports is printed. This includes reports defined under different WHEN
statements and different ON blocks.

Example
If the string BRANCH NOT BALANCED is found, the report decollating mission
should finish NOTOK.

490 CONTROL-D and CONTROL-V User Guide

 DO NOTOK: Decollating Parameter

Figure 250 DO NOTOK Parameter Example

----- CONTROL-D/V CATEGORY DAILY JOB PLUPDT02 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00002 - 00002 COL 00002 - 00040 PRINT REF NXT CT AND/OR A
STRING = UPDATE APPLICATION 2
WHEN LINE 00045 - 00060 COL 00025 - 00050 PRINT REF NXT CT N AND/OR
STRING = BRANCH NOT BALANCED
DO NOTOK
DO SHOUT TO TSO-SHFT-MNGR URGENCY R
= UPDATE OF ACCOUNTING DATA BASE NOT BALANCED
DO NAME = DB ACCOUNTING UPDATE
DO USER = ACCOUNTING LVL LINE COL -
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE 00001 - 00001 COL 00001 - 00001 PRINT REF NXT CT AND/OR
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Chapter 3 Decollating Mission Parameters 491

DO PRINT: Decollating Parameter

DO PRINT: Decollating Parameter

Specifies the names of the printing missions that can print or process the report.

Figure 251 DO PRINT Parameter Format

Type PRINT in the DO field and press Enter. Fields for specifying up to four printing
mission names and subparameter MUST are provided.

Table 214 DO PRINT Subparameters

Subparameter Description
name Mandatory. One or more printing mission names of 1 through 8
characters must be specified.
MUST Optional. Indicates whether or not the specified printing missions
must process the report even if it was already processed by another
mission. Valid values:

Y (Yes)The report must be processed by each print mission

specified on the line.
N (No)Default. The report is not processed by the specified
printing missions if it has already been processed.

General Information
Statement DO PRINT specifies the name of the printing missions to be used to print
the report. One or more DO PRINT statements can be specified. A maximum of five
printing missions can be specified. From one to four missions can be specified in each
DO PRINT statement. If a DO PRINT statement is not specified for a report, the
report is not printed but is available for online viewing.

If multiple printing missions are specified, the report is printed by the mission which
is activated first. If MUST is set to Y, the report is eventually printed by every printing
mission specified in that DO PRINT statement. The report is not printed by more than
one printing mission if MUST=N is specified for all the missions.

492 CONTROL-D and CONTROL-V User Guide

 DO PRINT: Decollating Parameter

If a report should be both printed and processed for transfer to

CONTROL-D/WebAccess Server, entering MUST=Y can ensure that the printing
mission which prints the report and the printing mission which prepares the report
for transfer are both executed.

When the same report name is specified in different ON blocks via DO NAME
statements, and these ON blocks contain different printing mission names in the DO
PRINT statements, the report can be printed by any of the printing missions specified
in any of those ON blocks.1

If *DEFAULT is specified as the first printing mission name, the printing mission
names are taken from the default record in the Permanent or Active User Report file.
If there is no default record, the other names specified in the report decollating
mission definition are used.

The status of a report is changed to PRINTED only after it has been printed by all
printing missions with parameter MUST set to Y. If a report has not yet been printed
by one of these missions, its status remains WAIT PRINT even if it has already been
printed.

Example
Printing mission STD or LATESTD should be used.

Figure 252 DO PRINT Parameter Example

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO PRINT = STD LATESTD MUST =
DO NAME = EMPLOYEES REPORT
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO BACKUP = BKP0031D
DO
WHEN LINE 00001 - 00001 COL 00001 - 00001 PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

1. Print missions are associated with unique combinations of user recipients and report names if Wish WD2104 is activated.

Chapter 3 Decollating Mission Parameters 493

DO REMARK: Decollating Parameter

DO REMARK: Decollating Parameter

Specifies a remark to be generated if the string specified in the WHEN statement is
found.

Figure 253 DO REMARK Parameter Format

Optional. Type REMARK (REMARK2 or REMARK3) in the DO field and press

Enter. The following subparameters are displayed:

Table 215 DO REMARK Subparameters (part 1 of 2)

Subparameter Description
REMARK Any text of 1 through 16 characters or * (asterisk) can be specified.
Mandatory.
REMARK2 Any text of 1 through 20 characters or * (asterisk) can be specified.
Mandatory.
REMARK3 Any text of 1 through 20 characters or * (asterisk) can be specified.
Mandatory.

494 CONTROL-D and CONTROL-V User Guide

 DO REMARK: Decollating Parameter

Table 215 DO REMARK Subparameters (part 2 of 2)

Subparameter Description
LINE Line containing the remark.

A 5-digit number from 00001 through 32768. Leading zeros must be

supplied. The parameter is optional and can only be specified when
REMARK is set to *.

If REMARK is set to * and LINE is blank, the remark is taken from

the line containing the WHEN string.

For ON TRNCLASS or ON TRNDSN the first digit of the line

number is set according to the orientation. For more information
see Creating a Text Report from the Print Stream Report (Second
Temporary Decollation Definition) on page 813.
Note: If the comparison operator in the STRING subparameter of the
WHEN parameter is set to .NE., do not use a blank value for the LINE
subparameter. This is because the .NE. setting indicates that a specific
line cannot be determined. For more details see the description of the
STRING field in a WHEN statement in Table 241 on page 623.
COL Column range of the remark, comprised of:

from_colA 5-digit number from 00001 through 32768. Leading

zeros must be supplied. from_col is mandatory when remark is set
to *.

to_colA 5-digit number from 00001 through 32768 that must be

greater than or equal to from_col. Leading zeros must be supplied.
to_col is mandatory when remark is set to *.

General Information
The DO REMARK (DO REMARK2 or DO REMARK3) statement specifies either a
user-defined remark or the line and column range on the report page where the
report name can be found.

The remark may be 1 through 16 characters for DO REMARK statements, or 1

through 20 for DO REMARK2 and DO REMARK3 statements, optionally preceded by
an asterisk. Embedded spaces are permitted. If the remark is preceded by an asterisk,
it is displayed as written. Otherwise, it is appended to any existing remark (such as a
return code) and may be truncated.

By default, return codes and termination codes are placed in the REMARK field (not
REMARK2 or REMARK3) if MSGCLASS output is decollated.

Entries in the DO REMARK (DO REMARK2 or DO REMARK3) field appear in

certain User Report list formats. Remarks can also be specified as selection criteria in
the REMARK/CCs (DO REMARK2 or DO REMARK3) fields in the Show Options
window of the User Reports entry panel or in the Active User Reports list.

Chapter 3 Decollating Mission Parameters 495

DO REMARK: Decollating Parameter

The LINE parameter is optional. If it is omitted, the line in which the WHEN string
was found is used.

The remark specified is used for all pages until a new DO REMARK (DO REMARK2
or DO REMARK3) is activated.

The remark field can be set to special values (described below) which begin with %%.

%%EXTWTR
The remark can be retrieved from the External Writer name. The format is

DO REMARK = %%EXTWTR[(startpos,length)]
DO REMARK2 = %%EXTWTR[(startpos,length)]
DO REMARK3 = %%EXTWTR[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

Example

ON CLASS ABC EXTWTR $* . . .

DO REMARK = %%EXTWTR(5,3)
DO REMARK2 = %%EXTWTR(5,3)
DO REMARK3 = %%EXTWTR(5,3)

%%JOBNAME
The remark can be retrieved from the name of the job which produced the output.
The format is

DO REMARK=%%JOBNAME[(startpos,length)]
DO REMARK2=%%JOBNAME[(startpos,length)]
DO REMARK3=%%JOBNAME[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

496 CONTROL-D and CONTROL-V User Guide

 DO REMARK: Decollating Parameter

%%USERID
The remark can be retrieved from parameter USER in the job statement. The format is

DO REMARK=%%USERID[(startpos,length)]
DO REMARK2=%%USERID[(startpos,length)]
DO REMARK3=%%USERID[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

%%DDNAME
The remark can be extracted from the DD name of the JCL statement which
references the file to be decollated. The format is

DO REMARK=%%DDNAME[(startpos,length)]
DO REMARK2=%%DDNAME[(startpos,length)]
DO REMARK3=%%DDNAME[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

(1,8) extracts the entire DD name.

%%FILE
This statement can be used to generate a unique number for the remark. The format
is:

DO REMARK=%%FILE[(startpos,length)]
DO REMARK2=%%FILE[(startpos,length)]
DO REMARK3=%%FILE[(startpos,length)]

where

startpos is the first digit to extract from the unique 5-digit file number
length is the number of digits to extract

(3,3) extracts the last 3 digits of the 5-digit number.

Chapter 3 Decollating Mission Parameters 497

DO REMARK: Decollating Parameter

In situations where multiple report outputs may be created by DD statements with

the same DD name, this statement is useful to ensure that each report has a unique
entry in the REMARKS field of the Active Reports file.

%%DSNLLQ
The remark can also be extracted from the low level qualifier of the data set name of
the file to be decollated. The format is

DO REMARK=%%DSNLLQ[(startpos,length)]
DO REMARK2=%%DSNLLQ[(startpos,length)]
DO REMARK3=%%DSNLLQ[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

Remark Generation by Concatenation

It is possible to generate a remark by concatenating strings extracted from the report
page with each other or with predefined strings.

The remark can be generated by using multiple DO REMARK (DO REMARK2 or DO

REMARK3) statements. Consider the following examples:

Example 1

DO REMARK=* LINE 00001 COL 00051 - 00061

DO REMARK=*+*P LINE 00004 COL 00026 - 00029

The remark is composed from the contents of line 4 column 26 to 29 followed by the
contents of line 1 column 51 through 61. The string +*P translates into the remark
identified by the previous DO REMARK statement.

Example 2

DO REMARK=* LINE 00001 COL 00051 - 00061

DO REMARK=*P+-TWO- LINE COL -
DO REMARK=*P+* LINE 00004 COL 00026 - 00029

The remark is composed from the contents of line 1 columns 51 through 61 followed
by the string TWO followed by the contents of line 4 columns 26 to 29. The string
*P+ translates into the remark identified by the previous DO REMARK statement.

498 CONTROL-D and CONTROL-V User Guide

 DO REMARK: Decollating Parameter

Only one + can appear in each DO REMARK statement. The combination DO

REMARK= *+*P+ ... is not valid.

Example 3

DO REMARK = *P+ABC

The remark consists of the remark identified by the previous DO REMARK statement
concatenated with the string ABC.

Example 4

When the report is not balanced, the text NOT BALANCED appears in the REMARK
field in the Active Report list (depending on display type).

Figure 254 DO REMARK Parameter Example 4

------- CONTROL-D/V CATEGORY DAILY JOB PRDKPL04 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PRDKPL04 GENERIC MONITOR
===========================================================================
DEF COPIES 00 LVL 10 USER UNIDENT DEST MAX COPIES
===========================================================================
ON DSN = DDNAME=SYSUT2,PGMSTEP=STEP02
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00045 - 00060 PRINT REF NXT CT AND/OR A
STRING = ACCOUNTS UPDATE REPORT
WHEN LINE 00001 - 00060 COL 00001 - 00070 PRINT REF NXT CT AND/OR
STRING = N O T B A L A N C E D
DO REMARK = NOT BALANCED LINE COL
DO NAME = ACCOUNTS UPDATE
DO
WHEN LINE 00001 - 00001 COL 00045 - 00060 PRINT REF NXT CT AND/OR
STRING = ACCOUNTS UPDATE REPORT
WHEN LINE 00001 - 00060 COL 00001 - 00070 PRINT REF NXT CT AND/OR
STRING = ALL ACCOUNTS BALANCED
DO NAME = ACCOUNTS UPDATE LINE COL -
DO USER = * LVL LINE 00001 COL 00082 - 00085
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Chapter 3 Decollating Mission Parameters 499

DO SET: Decollating Parameter

DO SET: Decollating Parameter

Assigns a value to a variable that can be used by other decollation parameters.

Figure 255 DO SET Parameter Format

Optional. Type SET in the DO field and press Enter. The following subparameters are
displayed:

Table 216 DO SET Subparameters (part 1 of 3)

Subparameter Description
%% Name of the variable, to the right of the first equal sign (=) in the
statement in the following format:

%%varname

where varname is the variable name. 1 through 8 characters.

varname cannot be one of the following system variables:

CONTNAME
EXTWTR
FILE
JOBNAME
USERID

500 CONTROL-D and CONTROL-V User Guide

 DO SET: Decollating Parameter

Table 216 DO SET Subparameters (part 2 of 3)

Subparameter Description
varvalue Value assigned to the variable, to the right of the second equal sign (=)
in the statement, in the following format:

{string | * | {%%var[(startpos,length)]} | <Xpath>}

where

string is a character or hexadecimal string (1 through 53

characters). The following rules apply when defining string:
If string contains trailing blanks, or the characters < or >, it
must be enclosed within (apostrophes).
If string is hexadecimal, it must be enclosed in
apostrophes with the letter X preceding it (Xstring).
A null string is specified as a space within
(apostrophes).
An * (asterisk) indicates that the value is extracted from the
decollated report. For details on how to use this option, see
Extracting a Value from a Decollated Report on page 504.
var is the name of another variable, including the system variables
EXTWTR, FILE, JOBNAME, USERID, and DSNLLQ. To extract a
substring of the other variable, use the format (startpos, length),
where
startpos is the starting position of the substring to be
extracted
length is the length of the substring to be extracted
Xpath is the list of node tag names (4 through 200 characters).
Xpath can be continued on the next four lines. The Xpath
expression is case-sensitive.
Each item in the list of tag names is the tag name to be searched in
the XML document, starting from the root tag through to the
element, from which the value is extracted.
For details on how to format Xpath, see Extracting a Value from
the XML List of Node Tag Names on page 505.
Note: The following standard Xpath options are not supported when
resolving an Xpath:

Double slash in the middle of expression.

Filtering according to attribute value and level number.
Search from current position.
Extracting values from comment and processing instruction
nodes.
Extraction from several text nodes at once.

The W3C standard Xpath will be supported in a future version.

Chapter 3 Decollating Mission Parameters 501

DO SET: Decollating Parameter

Table 216 DO SET Subparameters (part 3 of 3)

Subparameter Description
LINE Line containing the report name.

A 5-digit number from 00001 through 32768. Leading zeros must be

supplied. The parameter is optional and can only be specified when
varvalue is set to *.

If varvalue is set to * and LINE is blank, the value is taken from the
line containing the WHEN string.
For ON TRNCLASS or ON TRNDSN the first digit of the line
number is set according to the orientation. For more information
see Creating a Text Report from the Print Stream Report (Second
Temporary Decollation Definition) on page 813.
Note: If the comparison operator in the STRING subparameter of the
WHEN parameter is set to .NE., do not use a blank varvalue. This is
because the .NE. setting indicates that a specific line cannot be
determined. For more details see Table 241 on page 623.
COL Column range for the variable value, comprised of

from_colA 5-digit number from 00001 though 32768. Leading

zeros must be supplied. This parameter is mandatory when * is
used as the varvalue setting.
to_colA 5-digit number from 00001 though 32768 that must be
greater than or equal to from_col. Leading zeros must be supplied.
This parameter is mandatory when * is used as the varvalue
setting.
C Whether to concatenate DO SET variable values. Valid values are:

Y (Yes) Requires concatenation of variable values. In the C field,

type Y and press Enter. A continuation line is displayed for the
current DO SET line. Enter the variable to be concatenated to the
right of the equal sign (=).
N (No) Concatenation of variable values is not required. Default.
If a continuation line with a concatenated variable already exists
and you enter N, the concatenated variable is no longer displayed.
CS Change the case before the value is set, including the string value.
Valid values are:

U Change to uppercase
L Change to lowercase

General Information
The DO SET statement allows for the extraction of information from reports,
assigning that information to internal variables, and the manipulation of those
variables (such as concatenation and sub-string extraction). Additionally, strings can
extracted from XML documents and environment variables such as JOBNAME and
EXTWTR.

502 CONTROL-D and CONTROL-V User Guide

 DO SET: Decollating Parameter

DO SET Placement

The following are rules for placement of the DO SET parameter:

DO SET can be placed after an ON statement before the first WHEN statement.
DO SET can be placed after a WHEN statement or between other DO statements.
WHEN can be used with a list of DO SET statements without other DO statements.

Using Variables with the WHEN Statement

You can use variables with the WHEN LINE and WHEN VAR variants of the WHEN
statement. For an example of using variables with WHEN VAR and WHEN LINE, see
Example 2 on page 506. For more information on the WHEN statement, see
WHEN: Decollating Parameter on page 619.

Using Variables with DO Statements

Certain DO statements can contain variables, including the system variables

JOBNAME, EXTWTR, USERID, FILE, DSNLLQ, or a substring of the variable, using
the following format:

DO parameter [=] {reg_syntax | %%var1[(startpos,length)]}

where

reg_syntax is the regular syntax for the DO statement.

var1 is the variable name.
startpos is the starting position of the substring to be extracted.
length is the length of the substring to be extracted.

The following are the DO parameters that support variables, and their formats:

DO USER=%%<var1>
DO NAME=%%<var1>
DO REMARK=%%<var1>
DO REMARK2=%%<var1>
DO REMARK3=%%<var1>
DO PRINT=%%<var1> %%<var2> ...
DO BACKUP=%%<var1> %%<var2> ...
DO MIGRATE=%%<var1> (CONTROL-V only)

For an example of using variables with DO statements, see Example 3 on page 507.

Chapter 3 Decollating Mission Parameters 503

DO SET: Decollating Parameter

DO SET and Decollation Subtasks

In decollation subtasks, for each page that is processed, the following steps are
performed:

1. All DO SET statements that are placed before the WHEN statement are executed.

2. WHEN statements, including WHEN VAR, are checked.

3. DO statements, including DO SET, from their matching WHEN statements, are

executed.

The values assigned by DO SET for the current page may be used in DO statements
that appear later in the same page. These values can also be used in the WHEN
statements that begin on the next page.

NOTE
If a variable is used before it is assigned, it has a NULL value.

Extracting a Value from a Decollated Report

When using this option for setting a value for DO SET, do the following:

1 In the varvalue field, type * (asterisk), and press Enter. The LINE and COL fields
are displayed. The length of the varvalue field is reduced to 1 character.

NOTE
To switch back to the regular varvalue field, replace the * in the varvalue field with any
character other than a blank or * (asterisk), and press Enter. The LINE and COL fields are
hidden, and the length of the varvalue field is restored to its normal default.

2 Enter the line and column numbers for the report field you want to extract, in the
following format:

LINE[n] COL [km]

where

n is the line number

k is the first column from which the value is extracted
m is the last column from which the value is extracted

504 CONTROL-D and CONTROL-V User Guide

 DO SET: Decollating Parameter

For an example using of extracting a value using this method, see Example 1 on
page 506.

Extracting a Value from the XML List of Node Tag Names

When using this option for setting a value for DO SET, use the following format for
the XML path (Xpath):

<{/[/] {* | node}/.../{* | source_node}}>

where

node is the tag name of the XML node containing the needed element, in the form

tag[index]

where

tag is the tag name.

index is the tag number (starting at 1) in the tag collection. It is specified as a
sequential child number in the collection of tags with the specified name under
some parent. All tag names are separated by a slash (/).

source_node is the last element of the list (the source node tag name) in the form

{@attribute_name | text()[[index]]}

where

attribute_name is the attribute name of the source node tag name, which is used
as the variable value.

text() is the text node, with or without an index, which is used as the variable
value.

index is the tag number (starting at 1) in the tag collection. The index is enclosed
in [ ] (square brackets).

Searches for source tag names are performed using the following rules:

1. The search of source tag is implemented through the node tags from the parent
level through the child level.

2. If node is an * (asterisk), this indicates that any next level tag matches the search.

3. If Xpath begins with double slashes (//), the first tag is searched on all levels.

Chapter 3 Decollating Mission Parameters 505

DO SET: Decollating Parameter

XML Considerations

Because decollation subtasks process documents page-by-page, XML documents that

are referenced can contain one or more pages. The number of pages is determined by
setting an appropriate value for the LINECT CDAM control parameter. For more
information on the LINCECT parameter, see CDAM Control Parameters on
page 763.

You can split an XML report (EDCDIC only) into pages by setting the PRINT/CDAM
XMLSEP parameter to tagname. For more information on the XMLSEP parameter, see
CDAM Control Parameters on page 763.

Because XML documents do not have fixed line and column positions, you cannot
reference data from an XML document with any statement that contains the LINE
and COL parameters. Strings from the XML document must first be assigned to
variables using DO SET statements, after which they may be used in other WHEN
and DO statements.

For an example of extracting strings from an XML document, see Example 4 on

page 507.

Examples

Example 1

The following example shows the DO SET statements used to extract values from a
decollated report:

DO SET = %%ACC =* LINE 00001 COL 00001 - 00005 C CS

DO
WHEN LINE 00001 - 00001 COL 00001 - 00001 PRINT REF NXT CT AND/OR
STRING = %%ACC
DO
DO SET = %%REP ='REPORT FOR ' C CS
DO SET = %%REM_M =NEW C CS
DO
DO SET = %%REM_M =* LINE 00001 COL 00001 - 00005 C Y CS
DO = %%JOBNAME C Y CS
DO = %%REP(8,4) C Y CS
DO = %%CITY C CS

Example 2

The following is an example of using DO SET in conjunction with a WHEN VAR

statement:

506 CONTROL-D and CONTROL-V User Guide

 DO SET: Decollating Parameter

WHEN LINE - COL - PRINT REF NXT CT AND/OR

STRING =
DO SET = %%VAR1 =REP 1 C CS
DO SET = %%VAR2 =X'0AFA0F40F2' C CS
DO SET = %%VAR3 ='REP 2' C CS
DO
WHEN VAR %%VAR2 REF NXT CT AND/OR A
STRING = %%VAR3
WHEN LINE 00003 - 00003 COL 00034 - 00050 PRINT REF NXT CT AND/OR A
STRING = .NE.%%VAR2
WHEN VAR %%VAR2 REF NXT CT AND/OR
STRING = .NE.'REP '

Example 3

The following is an example of using variables with DO parameters:

WHEN LINE 00001 - 00001 COL 00001 - 00005 PRINT REF NXT CT AND/OR
STRING = TITLE
DO SET = %%VAR2 =* LINE 00001 COL 00001 - 00005 C CS
DO
WHEN LINE 00002 - 00002 COL 00001 - 00005 PRINT REF NXT CT AND/OR
STRING = TITLE2
DO SET = %%VAR2 =* LINE 00020 COL 00001 - 00005 C CS
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO USER = %%VAR2 LVL LINE COL -
S A T SYNONYM = CONCAT =

Example 4

The following is an example of the DO SET statement that extracts strings from an
XML document:

Chapter 3 Decollating Mission Parameters 507

DO SET: Decollating Parameter

ON CLASS = T EXTWTR DEST FORM

PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS = LINECT=9999,ASSOC=XML,XMLSEP=Document
PRINT/CDAM PARMS =
DO SET = %%VAR1 =</Document/*/Code_ID/text()> C CS
DO SET = %%VAR2 =</Document/*/Code_Rep_ID/text()> C CS
DO SET = %%REPM =</Document/*/Product_ID/text()> C Y CS U
=<//Product_Discription/text()> C Y CS U
DO SET = %%USR_R =</Document/Document_Content/Report_Header[ C CS U
1]/Partner_Information/Partner_Id/text()>
DO
WHEN VAR %%VAR1 REF NXT CT AND/OR
STRING = %%VAR2
DO USER = %%USR_R LVL LINE COL -
S A T SYNONYM = CONCAT =
DO NAME = %%REPM

508 CONTROL-D and CONTROL-V User Guide

 DO SHOUT: Post-Processing Parameter

DO SHOUT: Post-Processing Parameter

Sends a message to a specified destination when the string in the WHEN statement is
found.

NOTE
DO SHOUT and SHOUT statements are similar, but not identical. The differences are outlined
below in SHOUT/DO SHOUT Differences.

Figure 256 DO SHOUT Parameter Format

Optional. Type SHOUT in the DO field and press Enter. The following subparameters
are displayed:

Table 217 DO SHOUT Subparameters (part 1 of 2)

Subparameter Description
TO Destination of the message (1 through 16 characters). Mandatory.
Valid values are:

U-userid or USERID-userid Writes the message to the IOA Log

file under the specified user ID. userid must be 1 through 8
characters.

OPER[n] Sends a rollable message to the operator console. n is

an optional 2-digit route code. For more detailed information
regarding route and descriptor codes, refer to the IBM publication
Routing and Descriptor Codes, GC38-1102.

OPER2[n] Sends an unrollable, highlighted message to the

operator console. n is an optional 2-digit route code. If a route
code is not specified, the default routes are Master Console and
Programmer Information (1 and 11). For more detailed
information regarding route codes, refer to the IBM publication
Routing and Descriptor Codes, GC38-1102.

Chapter 3 Decollating Mission Parameters 509

DO SHOUT: Post-Processing Parameter

Table 217 DO SHOUT Subparameters (part 2 of 2)

Subparameter Description
TSO - loginid [;Nn | ;Mm | ;NnMm | ;Lname] Sends the message
to the specified ID (logonid). ID is mandatory (1 through 7
characters).
An optional second value, indicating the computer and/or node
(such as Nn) of the TSO logonid, can be specified, as follows:
Under JES2:
Valid values are Nn, Mm or NnMm, where
m is the machine ID (the computer in JES2, not the
4-character SMF ID). For more information, see Specify
IOA CPUs under Customization Process in the
Installing IOA chapter of the INCONTROL for z/OS Installation
Guide.
n is the 1 to 2 character JES/NJE node ID.
Under JES3:
The only valid value is Lname, where Lname is the logical JES name
of the machine (that is, the name as used in JES3 command *T, not
the SMF system ID).
For more information, see Specify IOA CPUs under
Customization Process in the Installing IOA chapter of the
INCONTROL for z/OS Installation Guide.
Note: A shout to a TSO user performs a TSO SEND command which
may require authorization at the receiving node.
URGENCY Determines the priority level of the message. Valid values:

RRegular. Default.
UUrgent.
VVery urgent.
= Message text. Maximum length: 70 characters.

AutoEdit variables (both system and user-defined) are supported and

automatically resolved (replaced) when the SHOUT message is
issued. For AutoEdit usage information, see Chapter 6 and Appendix
C.

General Information
The message is sent to the required destination when the accompanying ON
statement criteria are satisfied.

Subparameter TO

Enter TO=USERID-userid, to write the message to the IOA Log file under the user
ID specified in the parameter.

510 CONTROL-D and CONTROL-V User Guide

 DO SHOUT: Post-Processing Parameter

Enter TO=OPER[n], to send the message to the operator console (route code n). If
the n value is omitted, the message is sent to all consoles to which route codes 1 or 11
are assigned. For more detailed information regarding route and descriptor codes,
refer to the IBM publication Routing and Descriptor Codes, GC38-1102.

Enter TO=OPER2[n], to send a highlighted, unrollable message is sent to the

operator console (route code n). If the n value is omitted, the message is sent to all
consoles to which route codes 1 or 11 are assigned. For more detailed information
regarding route and descriptor codes, refer to the IBM publication Routing and
Descriptor Codes, GC38-1102.

Enter TO=TSO-id or T-id, to send the message is sent to the logonid. The Shout
facility first searches the IOA Dynamic Destination table for the specified ID. If the
table contains an entry that matches the value, the entrys content is used as the target
for the shouted message. (The entire TO field is used. Therefore, when directing the
message to a remote user, do not append Nn or Mm. Instead, do this in the IOA
Dynamic Destination table itself). For more information, see Dynamic Destination
Table in Chapter 2 of the INCONTROL for z/OS Administrator Guide.

If no matching ID is found in the Dynamic Destination table, the Shout facility

assumes the specified ID is a logonid. It then creates a TSO message that it hands over
to MVS. MVS then sends the message to that logonid. (If the logonid does not exist,
MVS cannot send the message, but no error message is generated.) When a second
value is used, the message is sent to the TSO logonid in the specified computer or
node (machine ID). To determine the machine ID under JES2, enter JES command
$LSYS.

Subparameter URGENCY

The URGENCY value indicates the urgency level of the message.

In addition, if the destination is USERID-userid (or U-userid), the user can control,
according to urgency, which messages are displayed when the IOA Log file is
accessed. Urgent and very urgent messages are highlighted on the screen. For more
details, see IOA Log Facility in Chapter 2.

SHOUT / DO SHOUT Differences

Statements SHOUT and DO SHOUT are similar but have the following differences:

Statement DO SHOUT is applied only if the accompanying WHEN criteria are

satisfied. Therefore statement DO SHOUT does not contain subparameters for
specifying when to perform the shout.

By contrast, statement SHOUT requires that a value be specified (in statement

WHEN) indicating when to shout the message. Messages can be shouted when the
mission ends OK, ends NOTOK, or does not finish executing on time.

Chapter 3 Decollating Mission Parameters 511

DO SHOUT: Post-Processing Parameter

A SHOUT statement appears in each mission scheduling definition. Statement DO

SHOUT does not appear unless specified. To specify a DO SHOUT statement, type
SHOUT in an empty DO field and press Enter.

The SHOUT URG subparameter is equivalent to the DO SHOUT URGENCY

subparameter.

The SHOUT MSG subparameter is equivalent to the DO SHOUT=msg

subparameter.

Example
Notify the shift manager that the Month-End Accounting report is ready for
decollation.

Figure 257 DO SHOUT Parameter Example

----- CONTROL-D/V CATEGORY ACTG JOB MONTHEND ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY ACTG JOBNAME MONTHEND GENERIC MONITOR
===========================================================================
DEF COPIES LVL USER DEST MAX COPIES
===========================================================================
ON CLASS = A EXTWTR DEST FORM
PRT COPIES LVL USER DEST MAX COPIES 01
PRINT/CDAM PARMS =
WHEN LINE 00002 - 00002 COL 00011 - 00037 PRINT REF NXT CT AND/OR
STRING = MONTH-END ACCOUNTING REPORT
DO SHOUT TO TSO-SHFT-MGR URGENCY R
= MONTH-END ACTG REPT READY FOR DECOLLATION
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
ON
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE - COL - PRINT REF NXT CT AND/OR
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 07.59.23

512 CONTROL-D and CONTROL-V User Guide

 DO USER: Decollating Parameter

DO USER: Decollating Parameter

Specifies the name and/or level of the user to whom the page identified in the WHEN
statement is sent.

Figure 258 DO USER Parameter Format

Optional. Type USER in the DO field and press Enter. The following subparameters
are displayed:

Table 218 DO USER Subparameters (part 1 of 3)

Subparameter Description
user_name A valid user name (1 through 8 characters for a Recipient name) in the
Recipient Tree. A synonym (1 through 20 characters) from the
Recipient Tree can also be used. Optionally, an * (asterisk) can be
specified; this precludes using an asterisk in the LVL field. Mandatory.

For more information, see Generic User Name below.

LVL A 2-character Recipient Tree level code. Optionally, * (asterisk) can be
specified; this precludes using an asterisk in the USER NAME field.
Optional.
LINE A 5-digit number from 00001 though 32768. Leading zeros must be
supplied. LINE can be specified only if * is used in the USER NAME or
LVL field. Optional.

If USER is set to * and LINE is blank, the user name is taken from
the line containing the WHEN string.

For ON TRNCLASS or ON TRNDSN the first digit of the line

number is set according to the orientation. For more information
see Creating a Text Report from the Print Stream Report (Second
Temporary Decollation Definition) on page 813.
Note: If the comparison operator in the STRING subparameter of the
WHEN parameter is set to .NE., do not use a blank value for the LINE
subparameter. This is because the .NE. setting indicates that a specific
line cannot be determined. For more details see Table 241 on page 623.

Chapter 3 Decollating Mission Parameters 513

DO USER: Decollating Parameter

Table 218 DO USER Subparameters (part 2 of 3)

Subparameter Description
COL Column range from which to extract the recipient user ID.

from_colA 5-digit number from 00001 though 32768. Leading

zeros must be supplied. This parameter is mandatory when * is
used.

to_colA 5-digit number from 00001 though 32768, which must be

greater than or equal to from_col. Leading zeros must be supplied.
This parameter is mandatory when * is used.
S A 1-character search code that indicates where to search for certain
decollation information. Valid values:

ASearch is performed on the Active User Report list.

(Installation default. It can be changed by the INCONTROL
administrator.)
PSearch is performed on the Permanent User Report list.
NNo search is performed.

For more information about parameter S(earch), see General

Information below.
T Type code that indicates how to handle report pages if the user is not
in the Recipient Tree or if the same pages were sent to the users
descendants in the Recipient Tree. Valid values:

UUnconditional. The user receives the report page if the users

name is in the Recipient Tree.

CConditional. The user receives the report page if the users

name is in the Recipient Tree and the users descendants do not
receive the page.

AAccept all users. The user receives the report page even if the
users name is not in the Recipient Tree. For more information, see
Decollation Without the Recipient Tree on page 803.

BBypass user examination. The user receives the report without

examination of the Recipient Tree

blankIf USER is set to *, the default is C (Conditional).

Otherwise, the default is U (Unconditional).
SYNONYM Code that indicates whether the report is sent to the first user or to all
users with the specified synonym. Optional. Valid values:

F (First)Recipient Tree is searched until the first user with the

specified synonym is found. Report pages are only sent to that
user. Default.

A (All)Report pages are sent to all users at the specified level (if
any) with the specified synonym.

514 CONTROL-D and CONTROL-V User Guide

 DO USER: Decollating Parameter

Table 218 DO USER Subparameters (part 3 of 3)

Subparameter Description
CONCAT Yes/No flag that indicates whether or not two or more line or column
ranges must be concatenated to produce the user name. Optional.
Valid values:

Y (Yes)Additional USER lines (for specifying user name strings

or line or column ranges) are displayed until a blank USER line is
specified.
N (No)Concatenation is not required. Default.

General Information
Statement DO USER specifies either the user name for the identified report page or
the line and column range on the report page where the user name can be found.

Enter an asterisk if the user name should be found on the report page, and then
specify the appropriate line and column ranges. Parameter LINE is optional. If it is
omitted, the line in which the WHEN string was found is used to search for the user
name.

CONTROL-V locates the first non-blank string in the specified area and searches for it
in the Recipient Tree. Whenever a DO USER is specified, CONTROL-V is originally
positioned on the last identified user in the tree. If the page does not belong to the
same user, a search is made for the user name (or synonym) in the tree. If LVL is also
specified, the search is limited to user names of the specified level.

The search is first conducted under the current position in the tree (that is, the
children). If not found, then a scan is conducted on all children of the last identified
users parent. The search continues until the user is found.

The recipient name comparison (between the report and the tree) is performed on a
character basis. It is possible to employ other comparison criteria using CONTROL-V
user Exit CTDX016. For example, check if the name in the report falls within a
specified range (such as catalog number) in the tree. For additional information see
Defining the Recipient Tree on page 791.

Any number of DO USER statements can be specified. They can be used either to
identify more than one recipient for the same page, or to identify specifically (point
to) the user location in the tree.

Special handling occurs when two or more DO USER=* statements are used. When
both a child and a parent are identified in DO USER=* statements, the parent receives
a copy of the report only if parameter TYPE is set to U. If parameter TYPE is set to C
(or blank), multiple DO USER statements can be used to point to a Recipient Tree
location.

Chapter 3 Decollating Mission Parameters 515

DO USER: Decollating Parameter

Example

Two DO USER=* statements are specified with different LINE/COL references. The
first yields the string BRANCH3 (parent) and the second yields the string FINANCE
(child). If TYPE is set to blank (or C), only user FINANCE (at BRANCH3) receives the
report. CONTROL-V does not generate a copy for the parent (BRANCH3). The first
DO USER statement specifies that the report belongs to the Finance Department of
BRANCH3 and not to the Finance Department of another branch.

*FORCE Option
This option can be used for defining sub-trees. When the user name starts with the
string *FORCE followed by either a user name or asterisk (*), special handling
occurs. This means that when two or more DO USER statements are used, the search
for the user name is not outside the branch of the tree identified by the user name in
the *FORCE statement. If *FORCE * is specified, a search is performed for user name
in the specified line or column range. After it is identified and a search is performed
for another user under it in the tree (because of another DO USER statement), the
search is limited to children of the identified user. *FORCE affects all DO USER
statements in the current ON block even if they are defined in another WHEN block.
For more information, see Defining the Recipient Tree on page 791.

Generic User Name

It is often necessary to send reports, or sections of reports, to a group of users (for
example, to all bank branches). It is, of course, possible to type a long list of DO USER
statements. This list needs to be updated for each such report whenever a new branch
is opened.

There is a better solution for specifying a generic group of recipients. Begin the
USER NAME with an asterisk, followed by a member name of 1 through 8 characters.
CONTROL-V then reads the list of users from the specified member, in the library
defined by DD statement DAGENUSR.

The interpretation of the generic user name is done when the mission is placed in the
Active Missions file. For more information, see also Defining a Generic User Name
List in the CONTROL-D and CONTROL-V chapter of the INCONTROL for z/OS
Administrator Guide.

The user_name field can be set to special values (described below) which begin with
%%.

%%EXTWTR
The user name can be retrieved from the External Writer name. Format:

516 CONTROL-D and CONTROL-V User Guide

 DO USER: Decollating Parameter

DO USER = %%EXTWTR[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

Example

ON CLASS ABC EXTWTR $* . . .

DO USER = %%EXTWTR(2,4)

NOTE
$* in ON CLASS parameter EXTWTR is a mask resulting in decollation of all outputs with a
writer name starting with $.

If the external writer name is empty, the original job name is used.

%%JOBNAME
The user name can be extracted from the name of the job which produced the output.
Format:

DO USER=%%JOBNAME[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

This option is useful for generic processing.

%%USERID
The user name can be extracted from the parameter USER in the job card. Format:

DO USER=%%USERID[(startpos,length)]

Chapter 3 Decollating Mission Parameters 517

DO USER: Decollating Parameter

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

%%DDNAME
The user name can be extracted from the DD name of the JCL statement which creates
the file to be decollated. Format:

DO USER=%%DDNAME[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

(1,8) extracts the entire ddname.

%%DSNLLQ
The user name can also be extracted from the low level qualifier of the data set name
of the file to be decollated. The format is:

DO USER=%%DSNLLQ[(startpos,length)]

where

startpos is the starting (first column) position of the extract

length is the number of characters to extract

Search Parameter (S)

When CONTROL-V decollates, it identifies a range of one or more pages that belong
to a specific recipient and have a specific report name. If search parameter (S) is set to
A, a search is then made in the Active User Report list for an entry with the same user
name, job name, report name, ODATE, and category. Such an entry is in WAIT
DECOLLATION status (copied by the utility CTDCP2A). If a matching entry is
found, the copy count, destination, form, class, printing missions (see parameter DO
PRINT), and additional users information are taken from that entry. These
parameters are described under User Reports (Online Viewing) on page 179. The
entry status is changed to WAIT PRINT (or DECOLLATED), and pointers in the entry

518 CONTROL-D and CONTROL-V User Guide

 DO USER: Decollating Parameter

refer to the correct pages in the CDAM file. If the entry is not found, the copy count
value is taken from the DEFAULT COPIES field (of the ON statement or the general
decollating mission default). Remaining parameters are set to default values unless
specified by other means.

If your site retrieves this information from the Permanent User Report list (and does
not permit user updates to the Active User Report list), the S=P option can be used.
The search is performed on the Permanent User Report list only. This eliminates the
need to perform a daily copy from the Permanent list to the Active list using utility
CTDCP2A.

By entering S=N, a search is not performed and decollation speed is enhanced.

Examples for the use of S=N include:

Decollation of production job MSGCLASS. The copies are usually determined in

the report decollating mission.

Sites which do not use CONTROL-V Permanent or Active file management.

If not specified, the report is sent to the first of the following recipients that is
specified:

The user specified in parameter USER of ON Statement DEFAULTS.

The user specified in parameter JOB DEFAULTS USER.
The user ID that is the root of the Recipient Tree. In this case, the decollating
mission ends NOTOK.

Examples

Example 1

The report pages identified by the WHEN statement belong to user MANAGEMENT
of level (department) 20.

Chapter 3 Decollating Mission Parameters 519

DO USER: Decollating Parameter

Figure 259 DO USER Parameter Example 1

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 10 USER UNIDENT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO USER = MANAGEMENT LVL 20 LINE COL -
S A T SYNONYM = CONCAT =
DO NAME = EMPLOYEES REPORT
DO PRINT = STD MUST =
DO BACKUP = BKP0180D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
ON DSN = DDNAME=PLRPT4,PGMSTEP=PLRPT010
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES 02
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

The specified report pages are sent to the Management Department. Unidentified
pages are sent to user UNIDENT.

Example 2

Report pages on which the identifying string EMPLOYEES REPORT is found belong
to user MANAGEMENT. Report pages on which the string VACATION SUMMARY
REPORT is found belong to user PERSONNEL.

520 CONTROL-D and CONTROL-V User Guide

 DO USER: Decollating Parameter

Figure 260 DO USER Parameter Example 2

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER UNIDENT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 11146 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO USER = MANAGEMENT LVL 20 LINE COL -
S A T SYNONYM = CONCAT =
DO NAME = EMPLOYEES REPORT
DO PRINT = STD MUST =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = V A C A T I O N S U M M A R Y R E P O R T
DO NAME = VACATION SUMMARY
DO USER = PERSONNEL LVL LINE COL -
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Example 3

The report is intended for all users defined in member BRANCHES. The generic user
name technique is used.

Figure 261 DO USER Parameter Example 3

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER UNIDENT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO USER = MANAGEMENT LVL 20 LINE COL -
DO USER = *BRANCHES LVL LINE COL -
S A T SYNONYM = CONCAT =
DO NAME = EMPLOYEES REPORT
DO PRINT = STD MUST =
DO BACKUP = BKP0007D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
ON DSN = DDNAME=PLRPT4,PGMSTEP=PLRPT010
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES 02
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Chapter 3 Decollating Mission Parameters 521

DSN: Runtime Scheduling Parameter

DSN: Runtime Scheduling Parameter

Specifies one or more dataset name identifiers for the compressed datasets of a job.

Figure 262 DSN Parameter Format

Optional. Only CDAM (Compressed Dataset Access Method) retrieval parameters

are specified in this field. A maximum of 44 characters can be specified. For a list of
valid CDAM parameters, see Chapter 5, Compressed Dataset Access Method
(CDAM).

General Information
Parameter DSN is intended for user parameter definition convenience. It is used
when a job does not write reports to spool but instead writes reports directly to
compressed datasets (using CDAM). In such cases, decollating these reports is
performed using ON DSN statements. CDAM retrieval parameters specified in the
DSN field are merged with CDAM retrieval parameters which are specified in the
ON DSN statements.

NOTE
Multijob CDAM files, created by using CDAM parameter ALLOCOPT=JOBSDSN1 or
ALLOCOPT=JOBSDSN2, cannot be used as input for a report decollating mission.

When the same CDAM parameter is specified in both a DSN field and an ON DSN
statement, the parameter in the ON DSN statement overrides the parameter in the
DSN field for that specific ON DSN statement (that is, not for all the ON DSN
statements in the job).

Example
This job creates a compressed dataset with the name PREFIX=SR01.

522 CONTROL-D and CONTROL-V User Guide

 DSN: Runtime Scheduling Parameter

Figure 263 DSN Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB SRDRPT ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME SRDRPT GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP SR-PRODUCTION JOBID
DESC DAILY REPORTS FROM SR APPLICATION
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN SR-APPLICATION-OK ODAT
WHEN IN QUEUE N CLS TIME FROM UNTIL INTERVAL PRIORITY 99
DSN PREFIX=SR01
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 523

GENERIC: General Parameter

GENERIC: General Parameter

Indicates whether the report decollating mission is or is not generic.

Figure 264 GENERIC Parameter Format

Optional. Valid values are:

Y (Yes) A generic decollating mission.

N (No) A non-generic decollating mission. Default.

NOTE
Y should not be specified if parameter TASKTYPE has a value of CRP (cyclic report
decollating mission).

General Information
A regular report decollating mission differs from a generic decollating mission in the
following way:

A regular report decollating mission is associated with a specific job name. It may
be triggered for execution by the appearance on the output queue of a job with the
same name. It is also possible to send all of the jobs outputs directly to compressed
datasets; therefore, no output appears on the spool for such a job. In this case,
triggering execution of the report decollating mission is accomplished using
prerequisite conditions.

A regular report decollating mission can decollate any output class specified in its
ON statements (see ON Statement later in this chapter). After decollation,
non-held output is deleted from the spool, held output remains on a JES2 but is
deleted from a JES3 spool, and the mission status is set to ENDED.

524 CONTROL-D and CONTROL-V User Guide

 GENERIC: General Parameter

A generic decollating mission can be defined for a specific job name but is usually
used in conjunction with a generic job name. A generic job name is specified using
mask characters (see Character Masking in Chapter 2). Execution of the report
decollating mission is triggered by the appearance of a job (whose name matches
the job name mask) in specific output classes (in non-held status). These output
classes are defined in CONTROL-D installation parameter GENCLAS. The
appearance of a matching job name in other output classes (or in held status in the
generic classes) does not trigger the execution of a generic decollating mission.

A generic decollating mission can decollate only from the generic classes defined
in the CONTROL-D installation parameters. Any output which is decollated by a
generic decollating mission is deleted from the spool.

For further information, see the CONTROL-D and CONTROL-V chapter in the
INCONTROL for z/OS Administrator Guide.

Examples
Generic decollating missions can be used for:

Handling of all MSGCLASS outputs of jobs in the same way move them from
spool to compressed datasets, allow online viewing of output, and retain backups
for two weeks.

Ad hoc jobs handling decollate output to users based on job prefix.

Chapter 3 Decollating Mission Parameters 525

GROUP: General Parameter

GROUP: General Parameter

Specifies the report decollating missions group name.

Figure 265 GROUP Parameter Format

Optional. 1 through 20 characters. Only trailing blanks are allowed.

General Information
This parameter provides a common descriptive name for a group of decollating
missions.

Parameter GROUP makes handling report decollating missions more convenient. It

enables retrieval of information about a specific groups report decollating missions,
usually via the Online facility or the Reporting facility.

The group name appears in all important messages relating to the groups report
decollating missions.

Assigning Line Numbers Inside a Page Using Print Control Characters

Enter GROUP=CHKCODE to optionally assign line numbers inside a page using

print control characters. Examples of printing control characters include: '+' and '-'
(ASA CONTROL-D characters), and x'19' (machine control characters).

Example
This report decollating mission belongs to the GENERAL-LEDGER group:

526 CONTROL-D and CONTROL-V User Guide

 GROUP: General Parameter

Figure 266 GROUP Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB GLRPT17A ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME GLRPT17A GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP GENERAL-LEDGER JOBID
DESC GENERAL LEDGER DAILY REPORTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 527

IN: Runtime Scheduling Parameter

IN: Runtime Scheduling Parameter

Prerequisite conditions for report decollating mission execution.

Figure 267 IN Parameter Format

Optional, but recommended. A maximum of two prerequisite conditions can be

specified in each IN line. When you specify the second prerequisite condition in a line
and press Enter, a new line is opened for specifying additional prerequisite
conditions.

Each specified prerequisite condition consists of the following subparameters:

Table 219 In Subparameters

Subparameter Description
cond_name User-supplied, descriptive name of 1 through 20 characters used to
identify the condition. Mandatory.
dateref 4-character date reference. Mandatory. Valid values are:

dateSpecific date (in either mmdd or ddmm format, depending

on the site standard).

STATStatic. Indicates that the condition (for example,

PRINTER-SET) is not date-dependent.

ODATOriginal schedule date. Default.

PREVPrevious date on which the mission should have been

scheduled, according to its basic scheduling criteria (or ODAT1 if
the mission is being forced).

$$$$Any scheduling date.

If a date reference is not specified, value ODAT is automatically

inserted when you press Enter.

528 CONTROL-D and CONTROL-V User Guide

 IN: Runtime Scheduling Parameter

General Information
The report decollating mission processes the jobs reports only if all the prerequisite
conditions specified in the IN statements are satisfied.

A prerequisite condition can represent any user-specified situation. The following are
examples of prerequisite conditions:

WEEKEND
JOB-EJGH12-FINISHED
PRINTER-SET

Mission execution dependencies can be defined and implemented by using

prerequisite conditions. Usage of prerequisite conditions encompasses
mission-to-mission or job-to-mission dependencies, or mission dependencies based
on successful completion of a manual task (such as data entry or quality control).

A prerequisite condition can be created or deleted in various ways. For further

information, see the description of the OUT and DO COND statements in this
chapter, Adding Conditions and Resources The ADD Command on page 370,
and Prerequisite Condition Concept on page 70.

Each prerequisite condition is associated with a specific scheduling date. This

scheduling date differentiates between different runs of the same report decollating
mission for different scheduling dates.

The PREV date reference automatically resolves to a scheduling date reference for the
report decollating missions previous scheduling date (or ODAT1 for a forced
mission).

The **** or $$$$ date reference indicates that any date is acceptable. Only the
prerequisite condition name must match.

Examples

Example 1

Activate the report decollating mission of the job which produces a twice-monthly
salary report when the job finishes OK. When the job that produces the salary report
finishes OK, it creates the prerequisite condition SALARY-OK.

Chapter 3 Decollating Mission Parameters 529

IN: Runtime Scheduling Parameter

The salary report job is run twice a month, for the 1st and for the 15th. Each report is
decollated only if its prerequisite condition SALARY-OK exists (signifying the job
creating that salary report ended OK). The existence of prerequisite condition
SALARY-OK created by the 1sts job does not cause decollating of the 15ths report.
The existence of prerequisite condition SALARY-OK created by the 15ths job does
not cause decollating of the 1sts report.

The 1sts job does not necessarily run on the 1st of the month. Suppose that job only
finishes executing on the 3rd. At that time, the prerequisite condition SALARY-OK
for the 1st is created. This is because the prerequisite condition is associated with the
missions scheduling date and not with the actual running date.

Figure 268 IN Parameter Example 1

------- CONTROL-D/V CATEGORY DAILY JOB SLRPT001 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME SLRPT001 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP SL-PRODUCTION JOBID
DESC SALARY REPORTS
DESC
===========================================================================
DAYS 01,15 DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 06
MINIMUM PDS
===========================================================================
IN SALARY-OK ODAT
WHEN IN QUEUE N CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CDMS: EDIT, SCHED, SHPF, PATH 08.43.06

Example 2

Suppose that a report should be decollated only after the totals of the report have
been checked for accuracy. Parameter IN can specify a prerequisite condition such as
REPORT12-CHECKED, which is created manually after the report has been checked.
For more information, see Adding Conditions and Resources The ADD
Command on page 370.

530 CONTROL-D and CONTROL-V User Guide

 IN: Runtime Scheduling Parameter

Figure 269 IN Parameter Example 2

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT012 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT012 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC REPORT 12
DESC
===========================================================================
DAYS 2,3,4,5,6 DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 06
MINIMUM PDS
===========================================================================
IN REPORT12-CHECKED ODAT
WHEN IN QUEUE N CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CDMS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 531

INTERVAL: Runtime Scheduling Parameter

INTERVAL: Runtime Scheduling Parameter

Specifies the minimum number of minutes to wait between successive executions of a
cyclic report decollating mission. See also TASKTYPE (Cyclic).

Figure 270 INTERVAL Parameter Format

Optional. Parameter INTERVAL specifies a number of minutes, from 000 through

255. Leading zeros are automatically inserted. The default value (blank) represents
000, which means there is no minimum time interval between executions of a cyclic
mission.

NOTE
If the value of INTERVAL is 000, the cyclic mission must be subject to an IN prerequisite
condition.

The specified interval starts from the time the previous mission finished executing.

General Information
A cyclic report decollating mission is generally executed at a regular interval defined
by parameter INTERVAL. Cyclic report decollating missions (see parameter
TASKTYPE) are used to process reports produced by multiple executions of jobs
having the same job name.

Parameter INTERVAL specifies the minimum time required between executions.

Other parameters (such as TIME or IN prerequisite conditions) can suppress or delay
the missions execution.

532 CONTROL-D and CONTROL-V User Guide

 INTERVAL: Runtime Scheduling Parameter

Any of the following can be used to process post-spool jobs (that is, jobs whose
reports are on the spool):

Generic decollating mission.

Cyclic decollating mission.
A number of scheduled regular report decollating missions equal to the number of
executions of the same job.

Example
Execute the report decollating mission every 60 minutes between 9 P.M. and 6 A.M.

Figure 271 INTERVAL Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PLRPTO1O ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPTO1O GENERIC N MONITOR
OWNER M22 TASKTYPE CRP GROUP PL-PRODUCTION JOBID
DESC PRODUCTION REPORTS
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE CLS TIME FROM 2100 UNTIL 0600 INTERVAL 060 PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 533

JOB DEFAULTS COPIES: Decollating Parameter

JOB DEFAULTS COPIES: Decollating Parameter

Default number of copies of the jobs reports to be printed for each recipient, if not
specified elsewhere.

Figure 272 JOB DEFAULTS COPIES Parameter Format

Optional.

Table 220 JOB DEFAULTS COPIES Subparameter

Subparameter Description
DEF COPIES Default number of copies. Valid values: 00 through 99. The default is
01. A leading zero is required.

General Information
The number of copies each report recipient receives is determined according to the
following algorithm:

The copy count defined for the user report in the Active or Permanent User Report
List file.

If not specified in the Active or Permanent User Report List file, the copies defined
in the ON statement describing the report.

If not specified in the ON statement, this parameter (the general job default copy
count) is used. The parameter defaults to 01 if not specified.

Parameter JOB DEFAULTS COPIES cannot be greater than parameter JOB

DEFAULTS MAX COPIES (whose default is 10).

Parameter JOB DEFAULTS COPIES can be overridden by parameter ON Statement

DEFAULTS MAX COPIES.

534 CONTROL-D and CONTROL-V User Guide

 JOB DEFAULTS COPIES: Decollating Parameter

The effect of setting JOB DEFAULTS parameters COPIES and MAXCOPIES to 99 is

described in parameter MAX COPIES of ON Statement DEFAULTS later in this
chapter.

Example
Print no copies of the jobs reports, unless otherwise specified in the Active or
Permanent User Report List file.

Figure 273 JOB DEFAULTS COPIES Example

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 11146 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Chapter 3 Decollating Mission Parameters 535

JOB DEFAULTS DEST: Decollating Parameter

JOB DEFAULTS DEST: Decollating Parameter

Default printing destination for those of the jobs report pages that are not identified
in ON statements.

Figure 274 JOB DEFAULTS DEST Parameter Format

Optional. The default destination is the main computer printer.

Table 221 JOB DEFAULTS DEST Subparameter

Subparameter Description
DEST Default print destination for pages of the jobs report not identified in
ON statements.
Note: Node values cannot be specified in report decollating missions.
Valid values are:

JES-printerA valid JES printer destination of 1 through 8

characters.

CTDPCUnidentified pages are prepared for transmission to a

PC. Under CONTROL-D/WebAccess Server print options, the
CONTROL-D/WebAccess Server user can specify printing
requirements.

CTDPCPRTUnidentified pages are prepared for transmission to

a PC and are automatically printed at the local PC printer.

*SPOOLUnidentified pages are sent to the original destination

specified for the report (on spool).

General Information
When a page in the jobs reports is not identified by a WHEN/DO USER statement
and a default destination is not specified in the ON Statement DEFAULTS, this
parameter designates where the pages is printed.

536 CONTROL-D and CONTROL-V User Guide

 JOB DEFAULTS DEST: Decollating Parameter

Printing by Original Destination (*SPOOL Option)

When CONTROL-V prints a report, it uses (as a default) the destination specified in
the Active User Report lists. (If the destination is not specified, it uses the main
computer printer.) It is the responsibility of the user to fill in the destination for each
report, user, or job (only once in the Permanent User Report List file). However, it is
sometimes inconvenient to do so, especially when using generic decollating missions
where the job name is not known. In such cases, there can be a requirement to print
the report on the original DEST specified for the report (on spool).

A special option exists in CONTROL-V for such situations. If destination *SPOOL is

specified in the JOB DEFAULTS DEST field, CONTROL-V determines the report
destination either by the original destination of the report on the spool, or according
to the DEST parameter in CDAM. This applies to all pages (identified and
unidentified).

This parameter is superseded by any destination specified in ON Statement

DEFAULTS, except the value *SPOOL which supersedes any destination specified in
ON Statement DEFAULTS. For further information, see Destination CONTROL-V
Search Order on page 833.

Example
Print all unidentified pages on printer RMT24.

Figure 275 JOB DEFAULTS DEST Parameter Example

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST RMT24 MAX COPIES 10
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Chapter 3 Decollating Mission Parameters 537

JOB DEFAULTS LVL: Decollating Parameter

JOB DEFAULTS LVL: Decollating Parameter

Default level of a user (recipient) who should receive every unidentified page of the
jobs reports.

Figure 276 JOB DEFAULTS LVL Parameter Format

Optional.

Table 222 JOB DEFAULTS LVL Subparameter

Subparameter Description
LVL 2-character code corresponding to a valid predefined level in the
Recipient Tree.

General Information
When a page in the jobs reports is not identified by a WHEN/DO USER statement
and a default user name and level are not specified in the ON Statement DEFAULTS,
a user whose level is specified in this parameter receives the unidentified pages.

Example
A recipient whose level in the Recipient Tree is 90 should receive each unidentified
page of the jobs reports.

538 CONTROL-D and CONTROL-V User Guide

 JOB DEFAULTS LVL: Decollating Parameter

Figure 277 JOB DEFAULTS LVL Parameter Example

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Chapter 3 Decollating Mission Parameters 539

JOB DEFAULTS MAX COPIES: Decollating Parameter

JOB DEFAULTS MAX COPIES: Decollating

Parameter
Maximum number of copies to be printed for the jobs reports unless otherwise
specified in an ON . . . . MAX COPIES statement.

Figure 278 JOB DEFAULTS MAX COPIES Parameter Format

Optional.

Table 223 JOB DEFAULTS MAX COPIES Subparameter

Subparameter Description
MAX COPIES Maximum number of copies of the report each user may receive. Valid
values: 00 through 99. Default: 10. A leading zero is required.

General Information
A CONTROL-V user can specify in the Active User Report List file how many copies
of each report are to be received.

Parameter JOB DEFAULTS MAX COPIES cannot be less than parameter JOB
DEFAULTS COPIES.

Parameter JOB Defaults MAX COPIES can be overridden by parameter ON Statement

Defaults MAX COPIES.

The effect of setting JOB DEFAULTS parameters MAX COPIES and COPIES to 99 is
described in parameter MAX COPIES of ON Statement DEFAULTS later in this
chapter.

540 CONTROL-D and CONTROL-V User Guide

 JOB DEFAULTS MAX COPIES: Decollating Parameter

Example
No more than 10 copies of the report should be printed unless otherwise specified in
an ON Statement Defaults MAX COPIES statement.

Figure 279 JOB DEFAULTS MAX COPIES Example

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST RMT24 MAX COPIES 10
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Chapter 3 Decollating Mission Parameters 541

JOB DEFAULTS USER: Decollating Parameter

JOB DEFAULTS USER: Decollating Parameter

Default name of a user (recipient) who should receive every unidentified page of the
jobs reports.

Figure 280 JOB DEFAULTS USER Parameter Format

Optional.

Table 224 JOB DEFAULTS USER Subparameter

Subparameter Description
USER Recipient name of 1 through 20 characters.

General Information
When a page in the jobs reports is not identified by a WHEN/DO USER statement
and a default user name and level are not specified in the ON Statement Defaults, the
user whose name is specified in this parameter receives the unidentified pages.

Example
A recipient whose name is UNIDENT should receive every unidentified page of the
jobs reports.

542 CONTROL-D and CONTROL-V User Guide

 JOB DEFAULTS USER: Decollating Parameter

Figure 281 JOB DEFAULTS USER Example

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Chapter 3 Decollating Mission Parameters 543

JOBID: General Parameter

JOBID: General Parameter

JES job identification number of the job that created the report to be decollated.

Figure 282 JOBID Parameter Format

Optional. Parameter JOBID specifies a JES job identification number. This parameter
can be used to uniquely identify the job that produced a specific report output when,
for any reason, several jobs exist with the same job name. Valid values:

Table 225 Valid JOBID Parameter Values

Value Description
JOBnnnnn Batch job ID number.
TSUnnnnn TSO user ID number.
STCnnnnn Started task ID number.
* JES job ID number of the job that orders the report decollating mission.
blank Any job number. Default.

General Information
When parameter JOBID is not specified and more than one report output exists which
meets the other criteria of a report decollating mission, the report which was
produced last is decollated by the mission. Parameter JOBID enables the user to
uniquely identify the report output which should be decollated.

An asterisk can be specified when a job which produces output for decollation
contains a step which orders a report decollation mission that should decollate such
output. The asterisk is replaced by the job identification number of the job that orders
the decollation mission. This ensures that this jobs output is decollated by the
decollation mission it orders.

544 CONTROL-D and CONTROL-V User Guide

 JOBID: General Parameter

Example
The report output from JES job number JOB12345 is decollated by this report
decollating mission.

Figure 283 JOBID Parameter Example

----- CONTROL-D/V CATEGORY DAILY JOB INVENT1 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME INVENT1 GENERIC MONITOR
OWNER M22 TASKTYPE REP GROUP JOBID JOB12345
DESC DAILY INVENTORY REPORT
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URG R
MSG ==== REPORT DECOLLATION FOR INVENT1 ENDED * NOTOK * ====
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 09.11.11

Chapter 3 Decollating Mission Parameters 545

JOBNAME: General Parameter

JOBNAME: General Parameter

Name of the job that produces the reports to be processed by the report decollating
mission.

Figure 284 JOBNAME Parameter Format

Mandatory. Parameter JOBNAME specifies a job name of 1 through 8 characters.

For a generic mission, the job name can contain mask characters.

General Information
The report decollating mission processes the reports (outputs) of the specified job
name.

Job Name Mask

When the report decollating mission type is generic, parameter JOBNAME can
contain a job name mask. This mask is compared with the job names appearing on the
generic output classes (see parameter GENERIC). For a description of the * and ?
mask characters, see Character Masking on page 83.

Example
The report to be decollated by this report decollating mission is produced by job
PLRPT010.

546 CONTROL-D and CONTROL-V User Guide

 JOBNAME: General Parameter

Figure 285 JOBNAME Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE DAILY REPORTS FOR ALL DEPARTMENTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 547

MAXWAIT: Basic Scheduling Parameter

MAXWAIT: Basic Scheduling Parameter

Number of extra days report decollating mission can wait in the Active Missions file
for execution.

Figure 286 MAXWAIT Parameter Format

Optional. Valid values: 00 98 (days) or 99 (no limit). A leading zero is required.

Table 226 MAXWAIT Parameter Values

Value Description
00 The report decollating mission is not executed if it did not execute on the
original scheduling date. Default.
nn Where nn is 01 through 98. If the report decollating mission did not
execute on its original scheduling date, it is given an additional number
of days to execute. It can remain in the Active Missions file up to nn days
awaiting execution.
99 The report decollating mission remains in the Active Missions file until
deleted manually, even if it has finished executing.

If no value is specified, the value 00 is automatically inserted.

General Information
The MAXWAIT parameter is used to overcome the problem of delays in production.
A report decollating mission that is scheduled for execution on a specific day does not
always finish executing that same day. This is the case when the job that produces the
reports has not yet run. A job may be delayed due to a number of reasons, such as
hardware failure, a heavy production workload, or a bug in one of the jobs
predecessors. Therefore, it may be desirable to specify an additional number of days
that the report decollating mission should remain available for execution.

548 CONTROL-D and CONTROL-V User Guide

 MAXWAIT: Basic Scheduling Parameter

When a report decollating mission cannot be executed within specified time limits, an
appropriate message is written to the IOA Log file, and the mission is deleted from
the Active Mission file.

When a report decollating mission is scheduled because parameter RETRO is set to Y,

the report decollating mission always has given at least one day to execute. This
occurs even if the current working date exceeds the MAXWAIT days after the report
decollating missions last original scheduling date. For additional information, see
RETRO: Basic Scheduling Parameter on page 594.

An emergency report decollating mission is also disregarded if its MAXWAIT period

has passed.

An emergency report decollating mission that belongs to a specific group (via

parameter GROUP) and whose MAXWAIT period has not passed is not deleted from
the Active Missions file until all regular report decollating missions belonging to the
same group have finished executing. This is desirable because the report decollating
mission may be needed again at a later stage (due to a job rerun).

The INCONTROL administrator can implement an option that causes report

decollating missions that terminate OK to also remain in the Active Missions file for
MAXWAIT days.

Examples

Example 1

The report decollating mission should remain in the Active Missions file indefinitely:

MAXWAIT=99

Example 2

The report decollating mission should be given an extra three days to execute after its
original scheduling date has passed:

DAYS=2,4,6
MAXWAIT=3

Assume that the report decollating mission does not run due to the absence of the
required runtime conditions. The report decollating mission that is scheduled for the
2nd of the month waits from the 2nd through the 5th to be executed.

On the 6th, CONTROL-V times out and the report decollating mission scheduled for
the 2nd is not executed. The report decollating missions scheduled for the 4th and 6th
wait for execution until the 7th and 9th, respectively.

Chapter 3 Decollating Mission Parameters 549

MAXWAIT: Basic Scheduling Parameter

Figure 287 MAXWAIT Parameter Example 2

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT026 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT026 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC MARCH EMPLOYEE REPORTS DURING SPECIAL PERIOD
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS 2,4,6 WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 03
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Example 3

Schedule the report decollating mission for every working day, whether or not the
computer is active. Give the report decollating mission one extra day to execute:

DCAL=WORKDAYS,
RETRO=Y,
MAXWAIT=1

Assume that calendar WORKDAYS, specified in parameter DCAL, contains the

values 15, 16, 18, and 19. The computer was off-line from the 16th up to and including
the 18th, and the 15th was the last date that the report decollating mission was
scheduled for execution.

Today is the 19th. The report decollating mission is scheduled three times with
original scheduling dates of the 16th, 18th and 19th.

The 16ths and 18ths report decollating missions are disregarded on the 20th if they
have not yet executed. The 19ths report decollating mission is disregarded only on
the 21st.

550 CONTROL-D and CONTROL-V User Guide

 MAXWAIT: Basic Scheduling Parameter

Figure 288 MAXWAIT Parameter Example 3

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT027 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT027 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE REPORTS FOR MANAGEMENT DEPARTMENT
DESC
===========================================================================
DAYS DCAL WORKDAYS
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 01
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 551

MINIMUM: Basic Scheduling Parameter

MINIMUM: Basic Scheduling Parameter

Minimum number of free tracks required by the library specified in parameter PDS.
See also PDS (later in this chapter).

Figure 289 MINIMUM Parameter Format

Optional. However, if PDS is specified, MINIMUM is mandatory.

Parameter MINIMUM specifies the minimum number of free tracks required. This
must be a positive 3-digit number (leading zeros are inserted automatically).

Parameter MINIMUM cannot be used with parameters DAYS, WDAYS, MONTHS,

CONFCAL, RETRO and DATES.

NOTE
This parameter is supported for compatibility with previous versions.

General Information
Parameters MINIMUM and PDS are always used together and are never used with
other Basic Scheduling parameters.

Parameter PDS identifies a library, and parameter MINIMUM specifies the minimum
number of free tracks required by that library.

These parameters are intended for use (definition) in missions that issue a warning
message if the minimum number of free tracks is not available.

552 CONTROL-D and CONTROL-V User Guide

 MINIMUM: Basic Scheduling Parameter

If parameters MINIMUM and PDS are defined for a mission, the scheduling of the
mission is not related to or dependent upon any date criteria. Instead, the mission is
scheduled if the actual number of free tracks available in the specified library is below
the specified minimum at time of daily mission ordering. The mission can then issue
the appropriate warning.

NOTE
MINIMUM does not work with PDSE-type libraries because they always appear to be 100%
full. MINIMUM only checks current extents.

Example
Schedule the mission when there are less than 20 unused tracks in library
ALL.PARMLIB.

Figure 290 MINIMUM Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PRDYHPDS ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PARMLB20 GENERIC N MONITOR
OWNER M22 TASKTYPE ERP GROUP PRODUCTION JOBID
DESC PARMLIB HAS LESS THAN 20 TRACKS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- 2- 3- 4- 5- 6- 7- 8- 9- 10- 11- 12-
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM 020 PDS ALL.PARMLIB
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN OK TO OPER2 URG U
MSG ALL.PARMLIB HAS LESS THAN 20 TRACKS
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 553

MONITOR: General Parameter

MONITOR: General Parameter

Identifies the CONTROL-V monitor or monitors that decollate the job.

Figure 291 MONITOR Parameter Format

Optional. Parameter MONITOR can be

blank
a number from 1 through 9
up to six numbers, each from 1 through 9, if the GENERIC parameter is set to Y

If the MONITOR field is left blank, the decollation monitor is dynamically selected
according to workload.

General Information
The parameter is used only when the site is activating more than one decollation
monitor for the same Active Missions file. This is usually done to allow parallel
decollating. (For more information see the CONTROL-D CTDMON# installation
parameter.) The parameter designates the ID of the monitor that processes the report
decollating mission.

If the value of the MONITOR parameter is blank and parameter GENERIC is set to Y,
the mission is duplicated to produce as many copies as the number specified in
parameter CTDMON# and each copy of the mission is assigned a different monitor
number (ID).

If the value of the MONITOR parameter is a list of numbers, and parameter

GENERIC is set to Y, the mission is duplicated to produce as many copies as the
number of monitors identified in the list, and each copy of the mission is assigned to
one of the monitors identified in the list.The monitor number (ID) cannot be greater
than the value of installation parameter CTDMON# .

554 CONTROL-D and CONTROL-V User Guide

 MONITOR: General Parameter

Example
Decollate the job by monitor 2.

Figure 292 MONITOR Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR 2
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE DAILY REPORTS FOR ALL DEPARTMENTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 555

MONTHS: Basic Scheduling Parameter

MONTHS: Basic Scheduling Parameter

Months of the year during which the report decollating mission should be scheduled
for execution.

Figure 293 MONTHS Parameter Format

Optional. Each month in the year is represented by a number from 1 through 12. A
value can be specified for each month. Valid values are:

Y (Yes) Schedule the report decollation mission in that month. Default.

N (No) or blank Do not schedule the mission that month.

General Information
The report decollating mission is scheduled for execution only during the months in
which a value of Y is specified.

Parameter MONTHS cannot be used with parameters PDS, MINIMUM and DATES.

When parameter MONTHS is used, at least one of the following must be specified:
DAYS, DCAL, WDAYS or WCAL. When specified with one of these parameters,
parameter MONTHS works as a filter to limit the mission schedule.

Parameter MONTHS is ignored when periodic values are specified in parameter

DAYS or WDAYS.

Examples

Example 1

Schedule a mission in all months of the year:

556 CONTROL-D and CONTROL-V User Guide

 MONTHS: Basic Scheduling Parameter

MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y

Example 2

Schedule a report decollating mission every day in March and September.

Figure 294 MONTHS Parameter Example 2

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT14B----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT14B GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE REPORTS FOR MANAGEMENT DEPARTMENT
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- N 2- N 3- Y 4- N 5- N 6- N 7- N 8- N 9- Y 10- N 11- N 12- N
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 557

MQ: General Parameter

MQ: General Parameter

The IBM WebSphere MQ queue from which an MQ decollating mission processes
messages.

Figure 295 MQ Parameter Format

Optional. Type Q in the GENERIC field in the decollating mission header and press
Enter. The following subparameters are displayed:

Table 227 MQ Subparameters

Subparameter Description
MQ QUEUE MQ queue name. 1 through 48 characters.
MAX MSG Maximum number of MQ messages that can be processed by the
mission before it passes control to the next mission in the Active
Missions file. 1 through 5 digits.

General Information
An MQ decollation mission is placed in the Active Mission File using either the
ORDER or FORCE options, as appropriate, from either the Job List Screen or
Category List Screen. The mission is activated as soon as a message is available in the
MQ queue defined for that decollation.

NOTE
Decollation missions working on a single MQ QUEUE should be activated under the same
control monitor.

As soon as the message is available in the MQ queue, the CONTROLD monitor

checks if there are corresponding MQ decollation missions in the Active Missions
File, and checks all ON MQ statements in these missions against the descriptor of the
received MQ message

558 CONTROL-D and CONTROL-V User Guide

 MQ: General Parameter

If there are several MQ decollation mission definitions with the same ON MQ

selection criteria in the Active Missions File, the first decollation mission that is
found, according to the priority set in the Active Missions File, processes the received
message.

If no appropriate mission is found, the message is moved to the MQ escape queue as

defined by the MQNOTFIND parameter in the CTDMQPRM member. For more
information on defining the MQ parameters in the CTDMQPRM member, see the
INCONTROL for z/OS Administrator Guide.

Example
Figure 296 MQ Parameter Example
CATEGORY FROM_QUEUE JOBNAME MQMJOBNM GENERIC Q MONITOR 4
MQ QUEUE CSQ1.MQMTEST MAX MSG 00001
===========================================================================
DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
===========================================================================
ON MQ USERID K46A ACCT
APPLID APPL4REPORT PRIORITY
APPLNM CTDTEST APPLT 1 FORMAT MQSTR
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO USER = BELLA LVL LINE COL -
S A T A SYNONYM = CONCAT =
DO NAME = MY_FIRST_TEST
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
PF 1=HELP 2=SPLIT 3=END 4=RETURN 5=RFIND 6=RCHANGE

Chapter 3 Decollating Mission Parameters 559

ON Statement: Decollating Parameter

ON Statement: Decollating Parameter

Selection criteria that determines the part of the jobs reports to which all instructions
within the ON block apply.

Figure 297 ON Parameter Format

Mandatory. One of the following keywords must be typed in the ON field:

Table 228 ON Subparameters (part 1 of 4)

Subparameter Description
CLASS Class names. The letter of the classes must be specified. A maximum
of eight held or non-held classes can be specified (for example, ON
CLASS ABCD). Only reports from the specified classes are decollated.

To limit the selection of sysouts from the specified classes, values can
be specified for the following subparameters:

EXTWTRName of an external writer to which the reports are

written. Only reports of the specified CLASS that are written to
the specified EXTWTR are decollated. The EXTWTR name has a
maximum of eight characters. Character masking (* for any
number of alphanumeric characters and ? for one alphanumeric
character) is supported. Character mask $* results in decollation of
all outputs with a writer name beginning with $.

DESTName of a printing destination for the reports. Only reports

of the specified CLASS with the specified DEST are decollated.
The DEST name has a maximum of eight characters.

FORMName of a printing FORM for the reports. Only reports of

the specified CLASS for the specified FORM are decollated. The
FORM name has a maximum of four characters.

560 CONTROL-D and CONTROL-V User Guide

 ON Statement: Decollating Parameter

Table 228 ON Subparameters (part 2 of 4)

Subparameter Description
DSN One or more CDAM selection criteria must be specified for the DSN
subparameter. The specification can occupy up to two lines. A
maximum of 101 characters can be entered: 44 on the first line, and 67
on the continuation line. For an example of how to format the selection
criteria, see Example 2 on page 566.

In the DSN specification, PGMSTEP=pgmstep and/or

PROCSTEP=procstep statements are often used as retrieval
parameters. However, CDAM control parameter ALLOCOPT cannot
be used in an ON DSN statement.
Note: pgmstep is the step name in the job, and procstep is the step name
in the JCL procedure.

If a procedure is not nested, the step that calls another procedure is

also PGMSTEP for ON DSN. In such a case, PGMSTEP is the same
step as specified in the STEPNAME field on the SDSF screen and
PROCSTEP is the same step as specified in the PROCSTEP field on the
SDSF screen.
MQ When an IBM WebSphere MQ message is available in the MQ queue
defined for the decollation mission, the ON MQ statement is executed.

The following subparameters, corresponding to parameters in the MQ

descriptor, can be used as selection criteria:

USERID The name of the user who sent the message.

ACCT The token or number of the message, determined by the

application that sent the message.

APPLID Additional information that the application has added

about the user.

APPLT Additional information about the kind of application

that sent the message. For example: CICS, Unix.

APPNM Name of the application that sent the message.

PRIORITY Number indicating the priority of the message.

FORMAT Format of the message.

Note: The MQSTR value in this field indicates that the report is a text
report. A blank or any other value in this field indicates that the report
is a binary report.
SYSJCL The expanded JCL system dataset.
SYSLOG The job log console messages system dataset.
SYSMSG The runtime execution messages system dataset.

Chapter 3 Decollating Mission Parameters 561

ON Statement: Decollating Parameter

Table 228 ON Subparameters (part 3 of 4)

Subparameter Description
SYSOUT Step and/or DD statement selection criteria. The following SYSOUT
subparameters can be specified:

PGMSTEP A specific program step. If blank, or if the reserved

word ANYSTEP is specified, all program steps are selected.
Length: 1 through 8 characters.

Note: PGMSTEP is the step name in the EXEC statement that

identifies the program to be executed:

//pgmstep EXEC PGM=pgmname

PROCSTEP A specific procedure step. If blank, or if the reserved

word ANYSTEP is specified, all procedure steps are selected.
Length: 1 through 8 characters.

Note: PROCSTEP is the step name in the EXEC statement that invokes
the procedure:

//procstep EXEC procname

DDNAME A specific DD name. If blank, all DD names are

selected. Length: 1 through 8 characters.
CLASS A specific class. If blank, all classes are selected.
TRNCLASS The same class and selection criteria fields as the CLASS subparameter
are displayed, with the addition of CLIQUE, which identifies the
Report Clique to be used for report transformation.

Instead of writing the original report to a CDAM file as with the

CLASS subparameter, CONTROL-D transforms the selected reports
into two formats: Normalized and Row Columnized (text). The
normalized report is then written to the CDAM file, and the text
format is used for the decollation process.

The transformation process is defined using the Report Clique

specified in the CLIQUE subparameter. For more information on
Report Cliques, see Report Cliques on page 329. For information on
preparing reports for transformation, see Decollation of Report
Types on page 807.

Currently, transformation is supported only for full AFPDS, Xerox

LCDS, and Xerox MetaCode reports.
Note: Although transformation using the TRNCLASS subparameter is
more efficient than using the TRNDSN subparameter, BMC Software
recommends using the TRNDSN subparameter instead of the
TRNCLASS subparameter for transformation. When transforming
reports using the TRNCLASS subparameter, the original report is not
saved. If there is a transformation failure, such as a missing resource
or an incorrectly transformed report, the original report cannot be
restored.

562 CONTROL-D and CONTROL-V User Guide

 ON Statement: Decollating Parameter

Table 228 ON Subparameters (part 4 of 4)

Subparameter Description
TRNDSN Selection criteria for selecting CDAM files must be defined. This
selection criteria is defined in the same way as described for the DSN
subparameter, with the addition of the CLIQUE subparameter, which
identifies the Report Clique to be used for report transformation.

Using the TRNDSN subparameter, a new CDAM file is created. The

report from the original CDAM file that is defined by the selection
criteria is transformed into two formats: Normalized and Row
Columnized (text). The normalized report is saved in the new CDAM,
and the text format is used for the decollation process.

The transformation process is defined using the Report Clique

specified in the CLIQUE subparameter. For more information on
Report Cliques, see Report Cliques on page 329. For information on
preparing reports for transformation, see Decollation of Report
Types on page 807.
Note: The original CDAM should be backed up in case the
normalization process fails. The normalized CDAM should be
processed for viewing, printing, and migration.

General Information
Each ON statement starts an ON block that extends to the next ON statement. An ON
block is comprised of an ON Statement, ON Statement Defaults and one or more
WHEN statements paired with DO statements. For a discussion of the ON Statement
Defaults, see ON Statement Defaults: Decollating Parameter on page 572.

Multiple ON statements can be specified in order to define different decollation

instructions for different parts of the report (for example, report output in Class A is
handled differently from report output in Class B).

When CONTROL-V decollates a non-held spool sysout, the sysout is removed from
the spool to the compressed sysout dataset.

When CONTROL-V decollates a held spool sysout, the sysout is copied from the
spool to the compressed sysout dataset. The original sysout remains on a JES2 spool
but is deleted from a JES3 spool.

NOTE
When CONTROL-V decollates a generic job, the sysout is always deleted from the spool.

Chapter 3 Decollating Mission Parameters 563

ON Statement: Decollating Parameter

CONTROL-V decollates only sysouts or compressed datasets of the job that are
defined by ON statements. Any reports of the job that are not included in the ON
statements (for example, certain classes) are not decollated. Therefore, they are not
available for online viewing, printing or backup.

ON CLASS decollates all the sysouts of the specified class (held and non-held). (For
generic decollating missions, only the non-held sysouts are processed.) It is possible
to specify multiple ON statements for the same class, each one containing a different
set of decollating criteria. It is also possible to apply a different set of decollating
criteria for the same report. This option is used only for special cases, examples of
which can be found later in this chapter. Normally, it is recommended to avoid
multiple ON statements for the same class.

At least one ON CLASS statement must be specified for a generic decollating mission.
This class must be defined as a generic class in the CONTROL-V installation
parameters. All other classes are rejected (for a generic job). A generic decollating
mission can contain only ON CLASS statements for generic classes.

NOTE
For further information, see Generic Job Considerations (JES2 only) on page 587.

ON DSN decollates all compressed sysouts that meet the selection criteria specified in
the ON DSN field. The selection criteria specified must be valid Compressed Dataset
Access Method (CDAM) control parameters (such as PREFIX, PGMSTEP or
PROCSTEP) that can be used for retrieval. For more information, see Chapter 5,
Compressed Dataset Access Method (CDAM) for a list of CDAM control
parameters that can be used for retrieval. The CDAM parameters specified in the ON
DSN statement are merged with the parameters specified in the DSN field of the
Runtime Scheduling parameters. In the case of duplicate parameters, the parameter
specified in the ON DSN statement overrides the parameter specified in the DSN
field.

Statement ON SYSOUT specifies selection criteria, depending on the type of output,

as follows:

For Held Sysout Selection

If an ON SYSOUT statement is specified and held sysout exists for the job,
CONTROL-V reads all the held sysout and selects output for processing based on the
specified selection criteria in the ON SYSOUT subparameters. If no selection criteria
are specified, all held sysouts are selected. Therefore, it is recommended to fill in at
least the CLASS subparameter.

564 CONTROL-D and CONTROL-V User Guide

 ON Statement: Decollating Parameter

For Non-Held Sysout Selection

If an ON SYSOUT statement is specified with an ON CLASS statements, ON SYSOUT
processes non-held output selected by the ON CLASS statements.

However, if only an ON SYSOUT statement is specified, the non-held sysout is

ignored.

NOTE
pgmstep is the step name in the job, and procstep is the step name in the JCL procedure:

ON SYSDATA is a general name for all system informational data of the job (SYSJCL,
SYSLOG, SYSMSG).

ON SYSLOG decollates only the job log console messages dataset of the job (first
dataset).

ON SYSJCL decollates only the expanded JCL system messages dataset of the job
(second dataset).

ON SYSMSG decollates only the runtime execution messages dataset of the job (third
dataset).

The ON SYSDATA, ON SYSLOG, ON SYSJCL and ON SYSMSG statements treat held

and non-held output in the same way as statement DO SYSOUT (described above).

Examples

Example 1

The ON statement defines decollating instructions for all the reports in class D.

Chapter 3 Decollating Mission Parameters 565

ON Statement: Decollating Parameter

Figure 298 ON CLASS Example Decollation Instructions

----- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES 10
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Example 2

The ON statement defines decollating instructions for a compressed dataset created

by DD statement DAREP4 in PGMSTEP APUX0030 of this job.

Figure 299 ON DSN Example

-------- CONTROL-D CATEGORY DAILY JOB PLRPT010 -----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON DSN = DDNAME=DAREP4,PGMSTEP=APUX0030
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES 02
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = * LINE COL -
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF 14.00.06

566 CONTROL-D and CONTROL-V User Guide

 ON Statement: Decollating Parameter

Example 3

The ON statement defines decollating instructions for the SYSDATA part of the job
output.

Figure 300 ON SYSDATA Example

-------- CONTROL-D CATEGORY DAILY JOB PLRPT010 -----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES LVL USER DEST MAX COPIES 05
===========================================================================
ON SYSDATA
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO USER = PRODCNTL LVL LINE COL -
S A T SYNONYM = CONCAT =
DO NAME = PRODUCTION JCL
DO BACKUP = BKP0007D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF 14.00.06

Chapter 3 Decollating Mission Parameters 567

ON Statement: Decollating Parameter

Example 4

The ON statement defines decollating instructions for all the SYSOUT of the job. The
output to be decollated is not restricted to a specified program step, procedure step,
ddname or class.

Figure 301 ON SYSOUT Example

----- CONTROL-D/V CATEGORY SYSOUT JOB M38 ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES LVL USER DEST CTDPC MAX COPIES
===========================================================================
ON SYSOUT PGMSTEP PROCSTEP DDNAME CLASS
PRT COPIES LVL USER DEST CTDPC MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO PRINT = CTDPC MUST =
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
ON
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 11.55.59

Example 5

The ON TRNCLASS statement performs standard decollation from the sysout in

SPOOL, using DAL transformation.

NOTE
The ON TRNCLASS statement cannot be used together with other ON CLASS statements for
the same class, and can be used only for an AFPDS Category 5 report. It is not necessary to use
a DO BACKUP for the original AFPDS report.

568 CONTROL-D and CONTROL-V User Guide

 ON Statement: Decollating Parameter

Figure 302 ON TRNCLASS Example

=============== DECOLLATION FROM SPOOL ====================

CATEGORY ON_TRNCLASS JOBNAME TRNSFOR GENERIC MONITOR

=========================================================================
ON TRNCLASS = A EXTWTR DEST FORM
CLIQUE = CLIQUE01
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00010 COL 00010 - 00020 PRINT REF NXT CT AND/OR
STRING = STRING1
DO USER = USER01 LVL LINE COL -
S N T SYNONYM = CONCAT =
DO NAME = NAME TRNCLASS REPORT
DO MIGRATE = MIGMIS
DO
WHEN LINE 00001 - 00010 COL 00010 - 00020 PRINT REF NXT CT AND/OR
STRING = STRING2
DO USER = USER02 LVL LINE COL -
S N T SYNONYM = CONCAT =
DO NAME = NAME TRNCLASS REPORT
DO MIGRATE = MIGNIS
DO
WHEN LINE 00001 - 00010 COL 00020 - 00030 PRINT REF NXT CT AND/OR
STRING = STRING3
DO USER = * LVL LINE COL 00030 - 00040
S N T SYNONYM = CONCAT =
DO NAME = * LINE COL 00040 - 00050
DO MIGRATE = MIGMIS
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =

Chapter 3 Decollating Mission Parameters 569

ON Statement: Decollating Parameter

Example 6

The ON CLASS statement creates a CDAM file from the sysout in SPOOL. The ON
TRNDSN statement uses DAL transformation to perform decollation from the
CDAM file created by the ON CLASS statement.

Figure 303 ON TRNDSN Example 1

CATEGORY SPOOL JOBNAME TRNSFOR GENERIC MONITOR
=========================================================================
DEF COPIES LVL USER DEST MAX COPIES
=========================================================================
ON CLASS = A EXTWTR DEST FORM
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO USER = USRBKP LVL LINE COL -
S N T SYNONYM = CONCAT =
DO NAME = NAME BKPCLASS REPORT
DO BACKUP = BKPMIS
DO PRINT = PRTMIS MUST =
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
=========================================================================
ON TRNDSN = PREFIX=CTD.PFX <=== prefix defined in AMPREFD in CTDPARM

CLIQUE = CLIQUE01
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00010 COL 00010 - 00020 PRINT REF NXT CT AND/OR
STRING = STRING1
DO USER = USER01 LVL LINE COL -
S N T SYNONYM = CONCAT =
DO NAME = NAME TRNCLASS REPORT
DO MIGRATE = MIGMIS
DO
WHEN LINE 00001 - 00010 COL 00010 - 00020 PRINT REF NXT CT AND/OR
STRING = STRING2
DO USER = USER02 LVL LINE COL -
S N T SYNONYM = CONCAT =
DO NAME = NAME TRNCLASS REPORT
DO MIGRATE = MIGNIS
DO
WHEN LINE 00010 - 00020 COL 00020 - 00030 PRINT REF NXT CT AND/OR
STRING = STRING3
DO USER = * LVL LINE COL 00030 - 00040
S N T SYNONYM = CONCAT =
DO NAME = * LINE COL 00040 - 00050
DO MIGRATE = MIGMIS
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =

570 CONTROL-D and CONTROL-V User Guide

 ON Statement: Decollating Parameter

Example 7

The ON DSN statement creates a backup of the CDAM file. The ON TRNDSN
statement uses DAL transformation to perform decollation from that CDAM. A new
CDAM file is created during ON TRNDSN decollation.

Figure 304 ON TRNDSN Example 2

========================== DECOLLATION FROM CDAM =========================

CATEGORY ON_TRNDSN JOBNAME TRNSFOR GENERIC MONITOR

=========================================================================
DEF COPIES LVL USER DEST MAX COPIES
=========================================================================
ON DSN = PREFIX=CTD.TRN

PRT COPIES LVL USER DEST MAX COPIES

PRINT/CDAM PARMS =
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO USER = USRBKP LVL LINE COL -
S N T SYNONYM = CONCAT =
DO NAME = NAME DSNBKP REPORT
DO BACKUP = BKPMIS
DO PRINT = PRTMIS MUST =
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
=========================================================================
ON TRNDSN = PREFIX=CTD.TRN

CLIQUE = CLIQUE02
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00010 COL 00010 - 00020 PRINT REF NXT CT AND/OR
STRING = STRING1
DO USER = USER01 LVL LINE COL -
S N T SYNONYM = CONCAT =
DO NAME = NAME TRNDSN REPORT
DO MIGRATE = MIGMIS
DO
WHEN LINE 00001 - 00010 COL 00010 - 00020 PRINT REF NXT CT AND/OR
STRING = STRING2
DO USER = USER02 LVL LINE COL -
S N T SYNONYM = CONCAT =
DO NAME = NAME TRNDSN REPORT
DO MIGRATE = MIGMIS
DO
WHEN LINE 00010 - 00020 COL 00020 - 00030 PRINT REF NXT CT AND/OR
STRING = STRING3
DO USER = * LVL LINE COL 00030 - 00040
S N T SYNONYM = CONCAT =
DO NAME = * LINE COL 00040 - 00050
DO MIGRATE = MIGMIS
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR

Chapter 3 Decollating Mission Parameters 571

ON Statement Defaults: Decollating Parameter

ON Statement Defaults: Decollating

Parameter
Default decollating and printing values for the ON block.

Figure 305 ON Statement Default Decollation and Printing Values Format

The ON Statement default subparameters can be optionally modified as follows:

Table 229 ON Statement Default Subparameters (part 1 of 2)

Subparameter Description
PRT COPIES Number of copies to print.

Valid values:

2-digit number from 00 through 97, or 98 or 99. A leading zero is

required.
LVL Level defined in the Recipient Tree.
USER User recipient name.

572 CONTROL-D and CONTROL-V User Guide

 ON Statement Defaults: Decollating Parameter

Table 229 ON Statement Default Subparameters (part 2 of 2)

Subparameter Description
DEST Print destination. Valid values are:

JES-printerA valid JES printer destination of 1 through 8

characters.

*SPOOLThe original destination specified for the report (on

spool) or in parameter CDAM DEST.

%%EWTRExternal writer name is picked up from spool or from

the PRINT/CDAM parameters, or both, and saved in the user
report entry.

CTDPCUnidentified pages are prepared for transmission to a PC.

Note: Under CONTROL-D/WebAccess Server print options, the PC
user can specify printing requirements.
CTDPCPRTUnidentified pages are prepared for transmission to
a PC and are automatically printed at the local PC printer.
MAX COPIES 2-digit number from 00 through 99, but not less than the PRT COPIES
number. A leading zero is required.

General Information
ON Statement defaults subparameters are applied to all pages in the jobs reports that
are decollated under the ON block and:

Are not identified by a WHEN statement (unidentified)

Are identified by a WHEN statement, but an overriding parameter is not defined
elsewhere.

NOTE
The MAX COPIES subparameter applies to all report pages within the ON block. It is unique
among the ON Statement Defaults in that no overriding parameter exists for it elsewhere. For
more information, see Printing by Original Destination (*SPOOL Option) on
page 575.

For information regarding the report destination, see Defining Report Recipients
on page 793.

PRT COPIES Subparameter

The PRT COPIES subparameter determines the default number of printing copies of
the reports defined under the ON statement. Valid values:

Chapter 3 Decollating Mission Parameters 573

ON Statement Defaults: Decollating Parameter

00 through 97The specified value is used for unidentified pages, or if no number

is specified for the report or recipient in parameter COP# of the Active User
Reports list. For more information, see User Reports in Chapter 2. A leading zero
is required.

98Copy count is equal to the copy count from the JCL multiplied by the copy
count of the default user record from either the Permanent or Active User file
(depending on the value of parameter S(earch) in the DO USER statement).

99Copy count is taken from the spool (that is, the copy count specified in the
JCL).

If ON Statement Default PRT COPIES is omitted, the value of parameter JOB

DEFAULTS COPIES are used instead for all the occurrences where this parameter
would apply.

NOTE
For more information see the example using different copies defaults in different ON
statements a few pages below.

LVL Subparameter

The LVL subparameter is the default level (in the Recipient Tree) of a user who
should receive every unidentified page of the reports defined under the ON
statement. If LVL is omitted, the general JOB DEFAULTS LVL is used instead for all
occurrences where this subparameter would apply.

USER Subparameter

The USER subparameter is the default name of a user who should receive every
unidentified page of the reports defined under the ON statement. If USER is omitted,
the general JOB DEFAULTS USER is used instead for all occurrences where this
subparameter would apply.

DEST Subparameter

The DEST subparameter is the default printing destination of the reports defined
under the ON statement. This printing destination is used for unidentified pages. If
DEST is omitted, the general JOB DEFAULTS DEST is used instead for all occurrences
where this subparameter would apply.

574 CONTROL-D and CONTROL-V User Guide

 ON Statement Defaults: Decollating Parameter

Printing by Original Destination (*SPOOL Option)

When CONTROL-V prints a report, it uses (as a default) the destination specified in
the Active User Report list. (If the destination is not specified, it uses the main
computer printer.) For additional information, see Defining Report Recipients on
page 793. It is the responsibility of the user to fill in the destination for each report,
user, or job (only once in the Permanent User Report file). However, it is sometimes
not convenient to do so, especially when using generic decollation missions where
the job name is not known. In such cases, there can be a requirement to print the
report on the original DEST which was specified for the report (on the spool).

A special option exists in CONTROL-V for such situations. The option is activated by
using the DEST field of the report decollating mission. If destination *SPOOL is
specified in the ON Statement DEST field, CONTROL-V determines the report
destination either by the original destination of the report on the spool, or according
to parameter DEST in CDAM. This applies to all pages (identified and unidentified)
processed by the current ON Statement. For more information, see Destination
CONTROL-V Search Order on page 833.

MAX COPIES Subparameter

The MAX COPIES subparameter is the maximum number of copies of the reports
defined under the ON statement that can be printed for a single user. This value
overrides any higher value specified in parameter COP (Copies) of the Active User
Report list. Subparameter MAX COPIES ensures that no user requests an
unreasonable number of copies. This parameter applies to all pages within the ON
block. If subparameter MAX COPIES is omitted, the general JOB DEFAULTS MAX
COPIES is used instead for all occurrences where this parameter would apply.

Subparameter PRT COPIES cannot be greater than subparameter MAX COPIES. If

COPIES is set to 99 and MAX COPIES is set to 99, the number of copies to print can be
specified in parameter COPIES of a CDAM JCL SUBSYS option. For more
information, see CDAM Parameters on page 760.

Examples

Example 1

Within the ON block, unless specified otherwise, one copy are printed of each page.
Unidentified pages go to user MGT (Level 20). No user can receive more than 10
copies of any report page.

Chapter 3 Decollating Mission Parameters 575

ON Statement Defaults: Decollating Parameter

Figure 306 ON Statement Default Decollation and Printing Values Example 1

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES 10
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT Y REF NXT N CT N AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = * LINE COL -
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

The site computer operations manager suspects that a hard copy of certain reports is
not needed by many users. The computer operations manager follows the steps
below:

Send a letter to all of the report recipients stating that from a specified date, the report
is no longer printed but it is available for online viewing. If a specific user wants to
receive printed report pages, the user must specify this in the Active or Permanent
User Report list.

On the specified date, change the PRT COPIES count of the report to 0. Users who did
not update the User Report list do not receive printed copies. However, they can still
access the User Reports list online and change their requested copy count. Many do
not; therefore, a considerable amount of paper can be saved.

If the same sysout class contains two reports, one for which a printed copy is needed
and another for which a printed copy is not needed, they must be defined in separate
ON statements for the same class. Each ON statement specifies a different default
PRT COPIES count.

Example 2

Specify different default PRT COPIES and MAX copies for two reports, both of class
A. Two ON CLASS statements must be used.

576 CONTROL-D and CONTROL-V User Guide

 ON Statement Defaults: Decollating Parameter

Figure 307 ON Statement Default Decollation and Printing Values Example 2

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT011 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = A EXTWTR DEST FORM
PRT COPIES 00 LVL 20 USER MGT DEST MAX COPIES 10
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT Y REF NXT N CT N AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = * LINE COL -
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
ON CLASS = A EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES 02
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT Y REF NXT N CT N AND/OR
STRING =E MPLOYEES S UMMARY R EPORT
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Chapter 3 Decollating Mission Parameters 577

OUT: PostProcessing Parameter

OUT: PostProcessing Parameter

Prerequisite conditions to be added and/or deleted when the report decollating
mission ends OK.

NOTE
OUT and DO COND statements are similar, but not identical. The differences are outlined
below in OUT/DO COND Differences.

Figure 308 OUT Parameter Format

Optional. A maximum of two prerequisite conditions can be specified in each OUT

line. Upon specifying the second prerequisite condition in a line and pressing Enter, a
new line is opened for specifying additional prerequisite conditions.

Each specified prerequisite condition consists of the following mandatory

subparameters:

578 CONTROL-D and CONTROL-V User Guide

 OUT: PostProcessing Parameter

Table 230 OUT Subparameters

Subparameter Description
cond_name User-supplied, descriptive name of 1 through 20 characters used to
identify the condition.
dateref 4-character date reference. Valid values are:

date Specific date (in either mmdd or ddmm format, depending

on the site standard).

STAT Static. Indicates that the condition (for example, TAPE-

READY) is not date-dependent.

ODAT Original scheduling date. Default.

PREV Previous date on which the mission should have been

scheduled, according to its basic scheduling criteria (or ODAT1
for a forced mission).

NEXT Next scheduling date (or ODAT+1 for a forced mission).

**** Any scheduling date. Valid only with opt= .

$$$$ Any scheduling date. Valid only with opt= .

If a date reference is not specified, value ODAT is automatically

inserted when you press Enter.
opt Indicates whether to add or delete the specified prerequisite
condition. Valid values:

+ Add (create) the prerequisite condition.

- Delete the prerequisite condition.

General Information
If the mission ends OK, the prerequisite conditions are added to or deleted from the
IOA Conditions file according to the specified opt value.

Prerequisite conditions are usually used to establish job or mission dependencies or

to ensure manual intervention when required.

To establish job or mission dependency, define a prerequisite condition in an OUT

or DO COND statement in the job or mission that should run first, and in an IN
statement in the job or mission that should run afterwards.

The job or mission containing a prerequisite condition in an IN statement is not

submitted unless that prerequisite condition has been added manually or by a job
or mission containing the OUT or DO COND statement.

Chapter 3 Decollating Mission Parameters 579

OUT: PostProcessing Parameter

An OUT statement is used to add the prerequisite condition if the job or mission
ends OK.

The DO COND statement is used to add the prerequisite condition if the

step/codes event criteria specified in the accompanying ON statement are
satisfied.

If the IN condition can only be satisfied by manual intervention (for example, if

TAPE1LOADED is set by the operator after the loading a tape), performance of
the required manual intervention before mission submission is ensured.

OUT and DO COND statements can also be used to delete prerequisite conditions. If
an IN prerequisite condition for a job or mission is not an IN prerequisite condition
for any other job or mission, you can use the OUT statement to delete a prerequisite
condition after the job or mission ends OK.

(For more information, see the description of parameter DO COND in this chapter.)

The following are examples of prerequisite conditions:

JOB_PAYCALC_ENDED_OK
PRINTER-SET

All prerequisite conditions are associated with a date reference that is used to
distinguish between different runs of the same job or mission with different
scheduling dates. If, for example, a condition is being deleted, only the condition
matching the specified date is deleted. The same condition with a different date is not
deleted. When adding or deleting prerequisite conditions, the date associated with
the prerequisite condition can be a specific 4-character date or one of the following
symbolic dates:

Table 231 Prerequisite Condition Symbolic Dates

Symbol Description
STAT Adds or deletes a prerequisite condition with the date value STAT.
ODAT Adds or deletes the prerequisite condition with the original scheduling
date of the job or mission.
PREV Adds or deletes the prerequisite condition with the previous scheduling
date of the job or mission (or ODAT1 if the job or mission is being
forced).
NEXT Adds or deletes the prerequisite condition with the next scheduling date
of the mission (or, for a forced mission, ODAT+1).
**** or $$$$ Valid only with an opt value of . Either of these values results in the
deletion of all matching prerequisite conditions regardless of date.

Prerequisite conditions created by parameter OUT can trigger the execution of other
jobs or missions.

580 CONTROL-D and CONTROL-V User Guide

 OUT: PostProcessing Parameter

Prerequisite conditions deleted by parameter OUT can prevent the scheduling of jobs
and missions that require those prerequisite conditions in their IN parameter.

For more information regarding prerequisite conditions, see Prerequisite Condition

Concept on page 70.

DO COND functions are performed after the functions of parameter OUT.

If a prerequisite condition is added by parameter OUT and deleted by parameter

DO COND, the combined effect is the deletion of the prerequisite condition.

If a prerequisite condition is deleted by parameter OUT and added by parameter

DO COND, the combined effect is the addition of that prerequisite condition.

Use of %%JOBNAME String

When the string %%JOBNAME appears inside an OUT prerequisite condition, it is
automatically replaced by the job name currently being processed by the report
decollating mission. The parameter is very useful for generic decollating missions. It
can trigger decollation missions that do not wait for a job in queue, but work on
CDAM datasets.

OUT / DO COND Differences

OUT and DO COND statements are similar but have the following differences:

Statement OUT is applied only if the mission ends OK. DO COND statements are
associated with WHEN statements and are applied only if the WHEN criteria are
satisfied.

An OUT statement appears in each mission scheduling definition. No DO COND

statement appears unless specified. To specify a DO COND statement, type COND
in an empty DO field and press Enter.

DO COND statements are processed after OUT statements and can therefore
override OUT statements.

Example
After the report decollating mission for the job that produces the salary report has
ended OK, permit printing (by a printing mission).

When the report decollating mission for the job that produces the salary report ends
OK, the prerequisite condition SALARY-DECOLLATED is added. This triggers the
execution of a printing mission that prints the report.

Chapter 3 Decollating Mission Parameters 581

OWNER: General Parameter

Figure 309 OUT Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB SLRPT001 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME SLRPT001 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP SL-PRODUCTION JOBID
DESC SALARY REPORTS
DESC
===========================================================================
DAYS 01,15 DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 06
MINIMUM PDS
===========================================================================
IN SALARY-OK ODAT
WHEN IN QUEUE N CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT SALARY-DECOLLATED ODAT +
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

OWNER: General Parameter

User who requests CONTROL-V decollating services.

Figure 310 OWNER Parameter Format

Mandatory. Parameter OWNER must be 1 through 8 characters.

General Information
Parameter OWNER is primarily used by CONTROL-Vs internal security mechanism
to determine which operations each user is authorized to perform.

582 CONTROL-D and CONTROL-V User Guide

 OWNER: General Parameter

Parameter OWNER can also facilitate the handling of production missions. When
using the Tracking and Control facility, you can restrict the display of CONTROL-V
information to specified users.

Parameter OWNER is passed to external security products such as RACF, TOP

SECRET and ACF2.

Default OWNER is dependent on the sites online environment (CICS, TSO, and so
on). For TSO and TSO/ISPF environments, the TSO user ID is the default. For
non-TSO environments such as CICS, the default is the terminal ID.

Example
Category DAILY of the report decollating mission belongs to M22.

Figure 311 OWNER Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE DAILY REPORTS FOR ALL DEPARTMENTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 583

PDS: Basic Scheduling Parameter

PDS: Basic Scheduling Parameter

Partitioned dataset (library) that should be checked for the minimum number of
required free tracks (specified in parameter MINIMUM). See also MINIMUM (earlier
in this chapter).

Figure 312 PDS Parameter Format

Optional. However, if MINIMUM is specified, PDS is mandatory.

Parameter PDS specifies a dataset of 1 through 44 characters.

Parameter PDS cannot be used with any of the following parameters: DAYS,
WDAYS, MONTHS, CONFCAL, RETRO and DATES.

NOTE
This parameter is supported for compatibility with previous versions.

General Information
The dataset must be cataloged, and it must be a partitioned dataset.

Parameters MINIMUM and PDS are always used together and are never used with
other Basic Scheduling parameters.

Parameter PDS identifies a library. Parameter MINIMUM specifies the minimum

number of free tracks required by that library.

These parameters are intended for use (definition) in missions that issue a warning
message if the minimum number of free tracks is not available.

584 CONTROL-D and CONTROL-V User Guide

 PDS: Basic Scheduling Parameter

If parameters MINIMUM and PDS are defined for a mission, the scheduling of the
mission is not related to or dependent upon any date criteria. Instead, the mission is
scheduled if the actual number of free tracks available in the specified library is below
the specified minimum when the New Day procedure is run. The mission can then
issue the appropriate warning.

NOTE
The PDS procedure does not work with PDSE-type libraries because they always appear to be
100 percent full.

Example
Schedule the mission when library ALL.PARMLIB has less than 20 unused tracks.

Figure 313 PDS Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PRDYHPDS ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PARMLB20 GENERIC N MONITOR
OWNER M22 TASKTYPE ERP GROUP PRODUCTION JOBID
DESC PARMLIB HAS LESS THAN 20 FREE TRACKS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- 2- 3- 4- 5- 6- 7- 8- 9- 10- 11- 12-
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM 020 PDS ALL.PARMLIB
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN OK TO OPER2 URG U
MSG ALL.PARMLIB HAS LESS THAN 20 FREE TRACKS
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 585

PRINT/CDAM PARMS: Decollating Parameter

PRINT/CDAM PARMS: Decollating Parameter

Printing characteristics to be used when printing the reports defined under the ON
statements.

Figure 314 PRINT/CDAM PARMS Parameter Format

Optional. If not specified, original printing characteristics are retained.

Any valid sysout printing parameter may be specified. The syntax should be identical
to JCL DD statement syntax. The validity of the parameters is checked.

Additionally, when decollating from the spool, it is possible to specify in this field
CDAM parameters that affect the CDAM operation (for example, PREFIX,
ALLOCOPT).

An additional empty line is always available for specifying additional parameters.

General Information
CONTROL-V uses report printing parameters defined under the ON statements
when PRINT/CDAM PARMS values are not specified. However, if specified,
PRINT/CDAM PARMS override the original printing characteristics of the reports
decollated under the ON statements.

CONTROL-V retrieves the printing characteristics of the reports when the reports are
read from the spool and moved to Compressed Dataset Access Method (CDAM)
format.

When the reports are written directly to compressed datasets, the printing
characteristics defined in parameter SUBSYS are kept. The printing characteristics are
subsequently used when printing from the compressed sysout.

586 CONTROL-D and CONTROL-V User Guide

 PRINT/CDAM PARMS: Decollating Parameter

$SYSDATA Records
Parameters specified in the PRINT/CDAM PARMS field are stored in a $SYSDATA
record in the Active User file. Even if several ON statements are specified for the
same class or CDAM file, only one $SYSDATA record is built for each file. Therefore,
only one set of PRINT/CDAM parameters is stored.

The following methods can be used to specify different PRINT/CDAM parameters

for different users and reports: Define the users and reports under different ON
statements. For ON DSN decollation, implement optional Wish WD1176 (see member
IOADFLTS in the IOA DOC library). For ON CLASS decollation, specify an ON
CLASS statement followed by an ON DSN statement referencing the CDAM file
created by the first ON CLASS statement. These methods cause extra passes through
the CDAM files but produce multiple $SYSDATA records containing the appropriate
PRINT/CDAM parameters.

Generic Job Considerations (JES2 only)

By default, the class of CONTROL-V printouts is the same as the class of the original
reports on spool. If this class is one of the generic output classes, CONTROL-V
decollates its own printouts. Therefore, it is highly recommended to override original
generic output classes by specifying a class that is not generic in a SYSOUT printing
parameter. If you do not do so, CONTROL-V prints the output in the class defined in
installation parameter ESCAPCL.

Laser Printing Considerations (IBM 3800 and 3900 Series)

JES2

Under JES2, no special considerations for laser printing are required. CONTROL-V
automatically retrieves the printing characteristics for report retrieval from the spool.

JES3

Under JES3, CONTROL-V retrieves from the spool only standard printer parameters
(CLASS, FCB, UCS, and so on). Laser printing characteristics for reports retrieved
from the spool must be specified in the PRINT/CDAM PARMS field. If two reports in
the same class have different laser printing characteristics, you must use two different
ON statements, each one with a different set of laser printing characteristics.

Chapter 3 Decollating Mission Parameters 587

PRINT/CDAM PARMS: Decollating Parameter

AFP (APA) Printers Considerations

Two JCL parameters control the printing of a report on AFP printers: FORMDEF and
PAGEDEF. These parameters cannot be specified in a standard DD statement.
Instead, they are specified in an OUTPUT statement. This output statement is
referenced from the DD statement.

Support for PAGEDEF and FORMDEF in CONTROL-V is implemented in the two

ways described below one is parallel to the original JCL approach (Using Specified
OUTPUT Statement); the other is more flexible and easier to use (Using Specified
PAGEDEF/FORMDEF).

Using Specified OUTPUT Statement

You can specify a name of an OUTPUT statement containing the
FORMDEF/PAGEDEF combination. When writing directly to a CDAM file, use the
CDAM parameter OUTPUT. When you decollate a report from spool, you must
specify the requested OUTPUT statement in the PRINT/CDAM PARMS field.
OUTPUT specified in the PRINT/CDAM PARMS field also overrides any such
parameter specified during CDAM file creation (in the DD statement).

NOTE
The name of the OUTPUT statement used is the name under the Printers Control monitor and
not the name of the OUTPUT statement in the job.

During the printing process, CONTROL-V looks for the specified OUTPUT statement
and uses it to print the report.

With this method, an OUTPUT statement must exist for every combination of
FORMDEF/PAGEDEF which is in use and it must exist under all printing
environments (the Printers Control monitor, the IOA monitor, the TSO user, and so
on). For site adaptations required for AFP support, see AFP Support in the
CONTROL-D chapter of the INCONTROL for z/OS Installation Guide.

This method is recommended for sites that use a small number of combinations of
PAGEDEF and FORMDEF parameters.

Using Specified PAGEDEF/FORMDEF

Under CONTROL-D you can specify parameters FORMDEF and PAGEDEF without
actually using an OUTPUT statement. When writing directly to a CDAM file, use the
CDAM parameters PAGEDEF and FORMDEF. When you decollate a report from
spool, PAGEDEF and FORMDEF are extracted from SPOOL. You can override the

588 CONTROL-D and CONTROL-V User Guide

 PRINT/CDAM PARMS: Decollating Parameter

extracted values by specifying PAGEDEF/FORMDEF in the PRINT/CDAM PARMS

field. PAGEDEF/FORMDEF specified in the PRINT/CDAM PARMS field also
overrides the values specified for these parameters in the DD statement during
CDAM file creation.

NOTE
This option is not supported when using the One-chunk printing method described in the
CONTROL-D and CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

This method is recommended for sites that use a large number of PAGEDEF and
FORMDEF specifications.

When using this option, during the printing process CONTROL-V looks for an
OUTPUT statement name CONTROLD and automatically inserts inline FORMDEF
and PAGEDEF. This option utilizes the AFP.

A CONTROLD OUTPUT statement must exist under all printing environments (the
Printers Control monitor, the IOA monitor, the TSO user, and so on). For site
adaptations required for AFP support, see AFP Support in the CONTROL-D
chapter of the INCONTROL for z/OS Installation Guide.

Overriding CDAM Parameters

When decollating from the spool, the CONTROL-V monitor writes the reports to
compressed (CDAM) datasets. The CDAM datasets are created according to defaults
defined in CONTROL-V installation parameters (AMPREFD, AMUNIT, and so on). It
is possible to override these defaults by specifying the parameters in the
PRINT/CDAM PARMS field. For example, you can place different reports on
different volumes by overriding parameter AMUNIT.

Use of ALLOCOPT Parameter

Using CDAM parameter ALLOCOPT in the PRINT/CDAM PARMS field saves disk
space and improve performance for short outputs. For further information, see
CDAM Parameters on page 760. However, multijob CDAM files, created by using
CDAM parameter ALLOCOPT=JOBSDSN1 or ALLOCOPT=JOBSDSN2, cannot be
used as input for a report decollating mission.

Chapter 3 Decollating Mission Parameters 589

PRINT/CDAM PARMS: Decollating Parameter

Decollating Reports Without Page Control Characters

Most reports produced in modern data centers are controlled by machine control
characters or ASA control characters. The control characters designate to the printer
(and to CONTROL-V) when a new page starts. However, there are reports that are
produced without control characters. Such reports are controlled by the value of
parameter LINECT assigned to them (in the DD statement, the job default, or the
printer default).

If you want to process such reports by CONTROL-V, you need to specify the number
of lines per page in CDAM parameter LINECT in the PRINT/CDAM PARMS field. If
the report is written directly to CDAM, parameter LINECT must be specified in the
CDAM parameters.

Printing Reports Without Page Control Characters

In order to print reports that do not have printing control parameters, you must
specify (for example) OUTPUT=OUT80 in the PRINT/CDAM PARMS field of the
reports and include DD statement OUT80 (see below) in the JCL for all print and
online monitors.

Example

PRINT/CDAM PARMS OUTPUT=OUT80

and

//OUT80 OUPTUT LINECT=80

Example
Specify different laser printing characteristics for two different reports.

590 CONTROL-D and CONTROL-V User Guide

 PRINT/CDAM PARMS: Decollating Parameter

Figure 315 PRINT/CDAM PARMS Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB D4REPTST ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
ON CLASS = A EXTWTR DEST FORM
PRT COPIES 00 LVL USER CRDBANK DEST MAX COPIES 05
PRINT/CDAM PARMS CHARS=(STDS,GHYA)
WHEN LINE 00001 - 00005 COL 00010 - 00070 PRINT Y REF NXT N CT N AND/OR
STRING = M O N T H L Y A/R R E P O R T
DO PRINT = STD MUST =
DO NAME = MONTH-A/R
DO USER = ACCOUNTING LVL LINE COL -
S A T SYNONYM = CONCAT =
DO
WHEN LINE - COL - PRINT Y REF NXT N CT N AND/OR
STRING =
DO
===========================================================================
ON CLASS = B EXTWTR DEST FORM
PRT COPIES 01 LVL 10 USER DEST MAX COPIES 05
PRINT/CDAM PARMS CHARS=GHSD,FLASH=Y
WHEN LINE 00001 - 00005 COL 00010 - 00070 PRINT Y REF NXT N CT N AND/OR
STRING = M O N T H L Y C A S H B A L A N C E
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 10.32.51

Chapter 3 Decollating Mission Parameters 591

PRIORITY: Runtime Scheduling Parameter

PRIORITY: Runtime Scheduling Parameter

Internal CONTROL-V report decollating mission priority.

Figure 316 PRIORITY Parameter Format

Optional. Parameter PRIORITY specifies a 1 or 2 character alphanumeric priority.

The default is blank, which is the lowest priority.

General Information
PRIORITY is used to help determine the order in which missions in the Active
Missions file are processed by CONTROL-V.

Priority is determined in ascending order where: blank < A < Z < 0 < 9

In general, the mission with the highest priority code executes first if its other runtime
scheduling requirements are satisfied.

Example
This report decollating mission has priority 99 and should be executed before all
report decollating missions with lower (or unspecified) priorities.

592 CONTROL-D and CONTROL-V User Guide

 PRIORITY: Runtime Scheduling Parameter

Figure 317 PRIORITY Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE DAILY REPORTS FOR ALL DEPARTMENTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY 99
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 593

RETRO: Basic Scheduling Parameter

RETRO: Basic Scheduling Parameter

Flag that indicates whether or not the report decollating mission should be scheduled
after its original scheduling date has passed.

Figure 318 RETRO Parameter Format

Optional. Valid values are:

Table 232 RETRO Values

Value Description
Y (Yes) Retroactively schedule the mission as described below.
N (No) Do not retroactively schedule the mission. Default.

General Information
The RETRO parameter is used to control situations where the computer has not been
working for a day or more due to hardware failure, holiday, and so on.

When such situations occur, it is necessary to instruct CONTROL-V whether or not

the report decollating mission should be retroactively scheduled for the days when
the computer (or CONTROL-V) was inactive. You should only set RETRO to Y if the
job which creates the reports is to be run for the days that the computer was down.

When RETRO is set to Y, report decollating missions are placed in the Active
Missions file for all the days the report decollating mission should have been
originally scheduled. Scheduling occurs from the last scheduling date to the current
working date, only if those days were included in one of the Basic Scheduling
parameters (DAYS, DCAL, and so on). Each report decollating mission placed on the
Active Missions file is associated with a different original scheduling date. For
additional information, see MAXWAIT: Basic Scheduling Parameter on page 548.

594 CONTROL-D and CONTROL-V User Guide

 RETRO: Basic Scheduling Parameter

When RETRO is set to N, the report decollating mission is only scheduled for the
current working date, only if the report decollating mission is normally scheduled for
that date.

RETRO cannot be used with the MINIMUM and PDS parameters.

Examples

Example 1

Schedule the report decollating mission only on specified days of the month. If the
date has passed, do not schedule the mission.

Figure 319 RETRO Parameter Example 1

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT021 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT021 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC MARCH EMPLOYEE REPORTS DURING SPECIAL PERIOD
DESC
===========================================================================
DAYS 15,16,18,19,20 DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Assume that the computer was off-line from the 15th to (and including) the 18th, and
the 15th was the last date that the report decollating mission was scheduled for
execution. Today is the 19th. The report decollating mission is first scheduled for
execution on the 19th, and not on the 16th, 17th, or 18th.

Example 2

Schedule the report decollating mission for every working day, whether or not the
computer is active.

Chapter 3 Decollating Mission Parameters 595

RETRO: Basic Scheduling Parameter

Figure 320 RETRO Parameter Example 2

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT021 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT021 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC MARCH EMPLOYEE REPORTS DURING SPECIAL PERIOD
DESC
===========================================================================
DAYS DCAL WORKDAYS
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Assume that the computer was off-line from the 16th to (and including) the 18th, and
the 15th was the last date that the report decollating mission was scheduled for
execution. Today is the 19th.

Assume that the WORKDAYS calendar contains the dates 15, 16, 18 and 19.
Therefore, the report decollating mission is scheduled three times with the original
scheduling dates: the 16th, 18th and 19th.

596 CONTROL-D and CONTROL-V User Guide

 SET: Decollating Parameter

SET: Decollating Parameter

Assigns an initial value to a system variable that is used during this decollation
process or a regular variable that can be used in this decollation mission.

Figure 321 Set Parameter Format

Optional. Type a variable name in the %% field and press Enter. If a system variable
beginning with the special character $ is specified, it is highlighted automatically.

Table 233 SET Subparameters (part 1 of 2)

Subparameter Description
%% Name of the variable in the statement, in the following format:

%%varname

where varname is the variable name. 1 through 8 characters.

varname can be one of the system variables beginning the special

character $, described in Table 234.

varname cannot be one of the following system variables:

CONTNAME
EXTWTR
FILE
JOBNAME
USERID
DSQ

Chapter 3 Decollating Mission Parameters 597

SET: Decollating Parameter

Table 233 SET Subparameters (part 2 of 2)

Subparameter Description
Varvalue Value assigned to the variable, to the right of the equal sign (=) in the
statement, in the following format:

string

where string is a character string (1 through 53 characters).

The values that may be specified for a system variables beginning the
special character $ described in Table 234.
C Whether to concatenate SET variable values. For future use.
CS Change the case before the value is set. For future release.

The system variable values that begin with the special character $ are
changed to uppercase automatically.

General Information
The SET statement allows for the initialization of system and regular variables at the
beginning of decollation mission execution.

System Variables
System variables define optional specific definitions for the current decollation
mission. Only specific values can be assigned for these variables in SET or DO SET
statements.

Table 234 System variables

Name Value Description
%MEMORY ABOVEBAR The memory above bar should be used for
indexing.

To use this option, the following must be present:

sufficient MEMLIMIT value in the

CONTROL-D procedure

sufficient disk space for the paging process

598 CONTROL-D and CONTROL-V User Guide

 SHOUT: Post Processing Parameter

SHOUT: Post Processing Parameter

Message to be sent (shouted) to a specified destination when a specific situation
occurs.

NOTE
Statements DO SHOUT and SHOUT are similar, but not identical. The differences are
outlined below in SHOUT/DO SHOUT Differences.

Figure 322 SHOUT Parameter Format

Optional. Upon filling in the SHOUT statement and pressing Enter, a new SHOUT
statement is opened.

Each SHOUT statement consists of four mandatory subparameters: WHEN

(situation), TO (destination), URG (urgency), and MSG (message text).

Table 235 SHOUT Subparameters (part 1 of 3)

Subparameter Description
WHEN Situation in which to send the message. Valid values are:

OKThe message is sent if the mission ends OK.

NOTOKThe message is sent if the mission ends NOTOK.
LATE timeThe message is sent if the mission does not finish
executing by the specified time, where time is in hhmm format.

Chapter 3 Decollating Mission Parameters 599

SHOUT: Post Processing Parameter

Table 235 SHOUT Subparameters (part 2 of 3)

Subparameter Description
EXECTIME limit The message is sent if the jobs elapsed
runtime is outside a specified limit. The limit can be expressed as
a runtime limit, or as a deviation from the jobs average runtime.
Valid formats for limit are (where n is a 3-digit nonzero value):
>n Jobs elapsed runtime is greater than n minutes.
n cannot exceed 999.
<n Jobs elapsed runtime is less than n minutes. n
cannot exceed 999.
+n Jobs elapsed runtime exceeds the jobs average
execution time by at least n minutes. n cannot
exceed 999.
n Jobs elapsed runtime is at least n minutes less than
the jobs average execution time. n cannot exceed
999.
+n% Jobs elapsed runtime exceeds the jobs average
execution time by at least n%. n cannot exceed 900.
n% Jobs elapsed runtime is at least n% less than the
jobs average execution time. n cannot exceed 99.
TO Destination of the message (1 through 16 characters). Mandatory.
Valid values are:

U-userid or USERID-useridWrites the message to the IOA Log

file under the specified user ID. userid must be 1 through 8
characters.

OPER[n]Sends a rollable message to the operator console. n is

an optional 2-digit route code. If a route code is not specified, the
default routes are Master Console and Programmer Information
(1 and 11). For more detailed information regarding route codes,
refer to the IBM publication Routing and Descriptor Codes,
GC38-1102.

OPER2[n]Sends an unrollable, highlighted message to the

operator console. n is an optional 2-digit route code. If a route
code is not specified, the default routes are Master Console and
Programmer Information (1 and 11). For more detailed
information regarding route codes, refer to the IBM publication
Routing and Descriptor Codes, GC38-1102.

600 CONTROL-D and CONTROL-V User Guide

 SHOUT: Post Processing Parameter

Table 235 SHOUT Subparameters (part 3 of 3)

Subparameter Description
TSO - loginid [;Nn | ;Mm | ;NnMm | ;Lname] Sends the message
to the specified ID (logonid). ID is mandatory (1 through 7
characters).
An optional second value, indicating the computer and/or node
(such as Mm) of the TSO logonid, can be specified, as follows:
Under JES2:
Valid values are Nn, Mm or NnMm, where:
m is the machine ID (the computer in JES2, not the
4-character SMF system ID). For more information, see
Specify IOA CPUs under Customization Process in
the Installing IOA chapter of the INCONTROL for OS/390
and z/OS Installation Guide.
n is the 1 to 2 character JES/NJE node ID.
Under JES3:
The only valid value is Lname, where Lname is the logical JES
name of the machine (that is, the name as used in JES3 command
*T, not the SMF system ID.
For more information, see Specify IOA CPUs under
Customization Process in the Installing IOA chapter of the
INCONTROL for z/OS Installation Guide.
Note: A shout to a TSO user performs a TSO SEND command, which
may require authorization at the receiving node.
URG Determines the priority level of the message. Valid values:

R - Regular. Default.
U - Urgent.
V - Very urgent.
MSG Message text. Maximum length: 70 characters.

AutoEdit variables (both system and user-defined) are supported and

automatically resolved (replaced) at the time the SHOUT message is
issued. For AutoEdit usage information see Chapter 6 and Appendix
C.

General Information
The message is sent to the specified destination when the WHEN condition is
satisfied. Multiple SHOUT statements can be evaluated and performed
independently.

Subparameter TO

Enter TO=USERID-userid, to write the message to the IOA Log file under the user
ID specified in the parameter.

Chapter 3 Decollating Mission Parameters 601

SHOUT: Post Processing Parameter

Enter TO=OPER[n], to send the message to the operator console (route code n). If
the n value is omitted, the message is sent to all consoles to which route codes 1 or 11
are assigned. For more detailed information regarding route and descriptor codes,
refer to the IBM publication Routing and Descriptor Codes, GC38-1102.

Enter TO=OPER2[n], to send a highlighted, unrollable message is sent to the

operator console (route code n). If the n value is omitted, the message is sent to all
consoles to which route codes 1 or 11 are assigned. For more detailed information
regarding route and descriptor codes, refer to the IBM publication Routing and
Descriptor Codes, GC38-1102.

Enter TO=TSO-id or T-id, to send the message is sent to the logonid. The Shout
facility first searches the IOA Dynamic Destination table for the specified ID. If the
table contains an entry that matches the value, the entrys content is used as the target
for the shouted message. (The entire TO field is used. Therefore, when directing the
message to a remote user, do not append Nn or Mm. Instead, do this in the IOA
Dynamic Destination table itself). For more information, see the section on Dynamic
Destination Tables in the IOA administration chapter of the INCONTROL for z/OS
Administrator Guide.

If no matching ID is found in the Dynamic Destination table, the Shout facility

assumes the specified ID is a logonid. It then creates a TSO message that it hands over
to MVS. MVS then sends the message to that logonid. (If the logonid does not exist,
MVS cannot send the message, but no error message is generated.) When a second
value is used, the message is sent to the TSO logonid in the specified computer or
node (machine ID). To determine the machine ID under JES2, enter JES command
$LSYS.

Subparameter URG

The URG value indicates the urgency level of the message.

In addition, if the destination is USERID-userid (or U-userid), the user can control,
according to urgency, which messages are displayed when the IOA Log file is
accessed. Urgent and very urgent messages are highlighted on the screen. For more
details, see IOA Log Facility in Chapter 2.

SHOUT / DO SHOUT Differences

Statements SHOUT and DO SHOUT are similar but have the following differences:

Statement DO SHOUT is applied only if the accompanying WHEN criteria are

satisfied. Therefore statement DO SHOUT does not contain subparameters for
specifying when to perform the shout.

602 CONTROL-D and CONTROL-V User Guide

 SHOUT: Post Processing Parameter

By contrast, statement SHOUT requires that a value be specified (in statement

WHEN) indicating when to shout the message. Messages can be shouted when the
mission ends OK, ends NOTOK, or does not finish executing on time.

A SHOUT statement appears in each mission scheduling definition. Statement DO

SHOUT does not appear unless specified. To specify a DO SHOUT statement, type
SHOUT in an empty DO field and press Enter.

The SHOUT URG subparameter is equivalent to the DO SHOUT URGENCY

subparameter.

The SHOUT MSG subparameter is equivalent to the DO SHOUT=msg

subparameter.

Example
If the report decollating mission does not finish executing successfully, send an
urgent, unrollable highlighted message to the operator console.

Figure 323 SHOUT Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB SLRPT001 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME SLRPT001 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP SL-PRODUCTION JOBID
DESC SALARY REPORTS
DESC
===========================================================================
DAYS 01,15 DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 06
MINIMUM PDS
===========================================================================
IN SALARY-OK ODAT
WHEN IN QUEUE N CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT SALARY-DECOLLATED ODAT +
SHOUT WHEN NOTOK TO OPER2 URG U
MSG DECOLLATING OF SALARY REPORT ENDED ABNORMALLY
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 603

TASKTYPE: General Parameter

TASKTYPE: General Parameter

Type of report decollating mission to be executed.

Figure 324 TASKTYPE Parameter Format

Mandatory. Valid TASKTYPE values:

Table 236 TASKTYPE Values

Value Description
REP Report decollating mission. Default.
CRP Cyclic report decollating mission.
ERP Emergency report decollating mission.

General Information
A report decollating mission (TASKTYPE REP) decollates regular production jobs.

A cyclic report decollating mission (TASKTYPE CRP) decollates jobs which are
repeatedly executed during a day.

An emergency report decollating mission (TASKTYPE ERP) decollates emergency

production jobs that is, jobs used to overcome irregularities in normal execution. An
emergency report decollating mission is only activated if the emergency job is
activated.

When using the Online facility it is possible to selectively retrieve regular, cyclic, or
emergency missions. This provides an additional means of control.

604 CONTROL-D and CONTROL-V User Guide

 TASKTYPE: General Parameter

Cyclic Missions
After a cyclic mission has finished executing, it returns to WAIT SCHEDULE state
and is recycled for additional possible executions. The mission executes again only
after the number of minutes specified in parameter INTERVAL has passed since the
last execution and the rest of its runtime scheduling criteria have been satisfied.

NOTE
TASKTYPE CRP should not be specified if the GENERIC parameter has a value of Y.
It is highly recommended that a cyclic mission delete the prerequisite conditions that
triggered its operation. Otherwise the mission might continually be resubmitted

Emergency Missions
An emergency mission can be used to overcome any irregularities in normal
execution. The mission remains in the Active Missions file, waiting to be scheduled,
until all regular missions of the same GROUP finish executing OK. Then, when the
emergency mission is no longer needed, the mission is automatically removed from
the Active Missions file. This process is performed once a day by the New Day
procedure. (For additional information, see parameter MAXWAIT in this chapter.).

NOTE
It is highly recommended that parameter GROUP be specified if you define emergency
missions. If GROUP is not specified, the mission may remain indefinitely in the Active
Missions file.

Example
PLRPT010 is a regular report decollating mission.

Chapter 3 Decollating Mission Parameters 605

TASKTYPE: General Parameter

Figure 325 TASKTYPE Parameter Example

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE DAILY REPORTS FOR ALL DEPARTMENTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

606 CONTROL-D and CONTROL-V User Guide

 TIME: Runtime Scheduling Parameter

TIME: Runtime Scheduling Parameter

Time limits (FROM, UNTIL) during which the decollating mission can be executed.

Figure 326 TIME Parameter Format

Optional. Parameter TIME consists of subparameters FROM and UNTIL. Either or

both subparameters can be specified.

The FROM and UNTIL fields can contain valid times in the format hhmm (where hh
is hour and mm is minute).

General Information
Normally, CONTROL-V submits the mission only during the time interval defined in
parameter TIME (that is, the mission is not submitted before the time specified in the
FROM field and is not submitted after the time specified in the UNTIL field).

When either a FROM and/or UNTIL value is not specified, the default is used. The
default values are the start and end of the work day as determined by the New Day
procedure.

Examples

Example 1

Execute the report decollating mission only between 9 P.M. and 6 A.M.

Chapter 3 Decollating Mission Parameters 607

TIME: Runtime Scheduling Parameter

Figure 327 TIME Parameter Example 1

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE DAILY REPORTS FOR ALL DEPARTMENTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM 2100 UNTIL 0600 INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Example 2

Start executing the mission no later than 0700 in the morning.

TIME FROM UNTIL 0700

Example 3

Execute the report decollating mission after midnight.

608 CONTROL-D and CONTROL-V User Guide

 TIME: Runtime Scheduling Parameter

Figure 328 TIME Parameter Example 3

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME PLRPT010 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP PL-PRODUCTION JOBID
DESC EMPLOYEE DAILY REPORTS FOR ALL DEPARTMENTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE Y CLS TIME FROM 0000 UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Chapter 3 Decollating Mission Parameters 609

WDAYS: Basic Scheduling Parameter

WDAYS: Basic Scheduling Parameter

Days of the week on which the report decollating mission should be scheduled. See
also CONFCAL and DAYS (earlier in this chapter).

Figure 329 WDAYS Parameter Format

Parameter WDAYS specifies days of the week on which report decollating missions
should be scheduled, only if other basic scheduling criteria are met.

Values for WDAYS can be specified alone, or they can be specified together with a
calendar specified in subparameter WCAL. WDAYS/WCAL can also be specified
together with DAYS/DCAL (described under DAYS earlier in this chapter).

The WDAYS subparameters are described below:

Table 237 WDAYS Subparameters (part 1 of 2)

Subparameter Description
WDAYS Days of each week in the month on which to schedule a mission. (The
months in which to schedule missions are specified in parameter
MONTHS.) Various formats (described later) can be used to specify
WDAYS (for example, 2 means the second day of the week, L2 means
the day before the last day of the week).
Notes: At time of installation, the INCONTROL administrator selects
either Sunday or Monday as the first day of the week. Your
INCONTROL administrator can tell you whether the week begins on
Sunday or Monday at your site.

The first six days of the week are coded 1 through 6. The last day of
the week is coded 0 (zero). All examples in this chapter assume
Monday is the first day of the week. In these examples, Monday = 1,
Tuesday = 2, ..., Saturday = 6, and Sunday = 0.

610 CONTROL-D and CONTROL-V User Guide

 WDAYS: Basic Scheduling Parameter

Table 237 WDAYS Subparameters (part 2 of 2)

Subparameter Description
WCAL Name of a calendar containing a predefined set of dates (referred to as
working days) on which a mission should be scheduled. The specified
value must be either a valid member name of 1 through 8 characters,
or an * to indicate that the calendar specified in parameter CONFCAL
should be used for scheduling. For information on how to define, use
and modify calendars, see IOA Calendar Facility in Chapter 2.
Note: A calendar specified in WCAL does not have to exist when
defining parameter WDAYS. However, it must exist when the mission
is scheduled.

Assuming all other basic scheduling criteria are met:

When WDAYS are specified without WCAL, the mission is scheduled on the
specified days of the week.

When WCAL is specified without WDAYS, the mission is scheduled on the

working days marked in the WCAL calendar.

When WDAYS and WCAL are both specified, scheduling depends on the
combination of working days defined in the calendar and the values or format of
parameter WDAYS (described below).

When both DAYS and WDAYS criteria are specified, scheduling depends on the
connecting AND/OR value specified. (For more information, see subparameter
AND/OR in parameter DAYS.)

Valid Formats for WDAYS

Valid formats for the WDAYS parameter, and how they relate to WCAL, are
described below.

Non-periodic scheduling

The following rules govern the use of non-periodic scheduling formats:

n is an integer from 0 to 6, where 1 is the first day of the week (Sunday or Monday,
depending on the standards at your site) and 0 is the last day of the week (either
Saturday or Sunday).

Multiple values can be specified (separated by commas) in any order.

If a calendar name is specified for WCAL, it should not designate a periodic

calendar.

Chapter 3 Decollating Mission Parameters 611

WDAYS: Basic Scheduling Parameter

Table 238 Non-Periodic Scheduling Formats

Format Description
ALL All days in the week. If ALL is specified, other WDAYS values cannot be
specified with it.

If a WCAL calendar is not defined, schedule the job or mission on all days
in the week.

If a WCAL calendar is defined, schedule the job or mission only on the

working days indicated in the calendar.
n,... Specific days of the week.

If a WCAL calendar is not defined, schedule the job or mission on the

specified days.

If a WCAL calendar is defined, schedule the job or mission only when a

day is defined as a working day in both the WDAYS and the WCAL
parameters.
+n,... Days of the week in addition to the working days specified in the WCAL
calendar. WCAL is mandatory.
n,... Schedule the mission on all days except the nth day from the beginning of the
week. WCAL is mandatory.
>n,... Order the job or mission on the indicated day if it is a working day in the
WCAL calendar; otherwise, order the job or mission on the next working day
(within the next seven days) that is not negated by a n value in the
parameter. If none of the next seven days is a working day, the job or mission
is not ordered. This format is frequently used for holiday handling. WCAL is
mandatory.
<n,... Order the job or mission on the indicated day if it is a working day in the
WCAL calendar; otherwise, order the job or mission on the last previous
working day (within the preceding seven days) that is not negated by a n
value in the parameter. If none of the preceding seven days was a working
day, the job or mission is not ordered. This format is frequently used for
holiday handling. WCAL is mandatory.
Dn,... Order the job or mission on the nth working day from the beginning of the
week. WCAL is mandatory.
Dn,... Order the job or mission on all working days except the nth working day from
the beginning of the week. WCAL is mandatory.
Ln,... Order the job or mission on the nth working day from the end of the week.
WCAL is mandatory.
Ln,... Order the job or mission on all working days except the nth working day from
the end of the week. WCAL is mandatory.
DnWm,... (Where m = 16). If WCAL is defined, order the job or mission on the nth day
of the mth week of the month. If WCAL is not defined, order the job or
mission on the mth appearance of the nth day of the week during the month.
WCAL is optional.
Note: When specifying DnWm with a calendar in the WCAL field, do not
code n as 0. This may produce unpredictable results.

612 CONTROL-D and CONTROL-V User Guide

 WDAYS: Basic Scheduling Parameter

Periodic scheduling

The following rules govern the use of periodic scheduling formats:

n is any integer from 0 to 6, and i is any valid period identifier (or * for all periods).

WDAYS period identifiers are counted on a week by week basis. Calculations do

not cross week boundaries (unlike DAYS periodic identifiers which do cross
month boundaries).

The name of a periodic calendar must be specified in WCAL.

A maximum of eight periodic values can be designated in any desired order.

Table 239 Periodic Scheduling Formats

Format Description
DnPi,... Order the job or mission on the nth day of period i in each week, from the
beginning of the week.
DnPi,... Order the job or mission on all days except the nth day of period i in each
week, from the beginning of the week.
LnPi,... Order the job or mission on the nth day of period i in each week, from the last
day of the week.
LnPi,... Order the job on all days in period i except the nth day of period i in each
week, from the last day of the week.

General Information
Negative values take precedence over positive values when determining whether or
not a mission is scheduled on a certain date. If a negative value (such as format n,
Dn, Ln, DnPi, or LnPi) in either the DAYS or WDAYS field prevents a mission
from being scheduled on a date, the mission is not scheduled on that date even if a
positive value (such as Ln) would otherwise result in the mission being scheduled on
that date.

A maximum of eight periodic values (such as types DnPi LnPi, and LnPi) can be
designated in any desired order.

If periodic and non-periodic values are mixed when specifying parameter

WDAYS, processing depends on the calendar type specified in parameter WCAL:

If a non-periodic calendar is specified in the WCAL parameter, only non-periodic

values in the WDAYS parameter are processed; periodic values are ignored. In this
case, negative periodic values such as DnPi and LnPi are also ignored and do not
supersede other values.

Chapter 3 Decollating Mission Parameters 613

WDAYS: Basic Scheduling Parameter

If a periodic calendar is specified in the WCAL parameter, all periodic values and
the negative non-periodic value -n in the WDAYS parameter are processed; all
nonnegative non-periodic values are ignored.

Parameter MONTHS is ignored when periodic values are specified in parameter

WDAYS.

Parameter WDAYS cannot be used with parameters PDS and MINIMUM.

When Ln and/or Dn values are specified in a week which overlaps two months, the
MONTHS value of the earlier month determines whether or not Dn or Ln values are
applied in the week:

If the first day of the week falls in a month with a MONTHS value of Y, all Dn and
Ln values in that week are applied, even those falling in the next or previous
month when that month has a MONTHS value of N.

If the first day of the week falls in a month with a MONTHS value of N, no Dn or
Ln values in that week are applied (not even if those falling in the next or previous
month when that month has a MONTHS value of Y).

Examples
The examples for this parameter are based on the following assumptions:

The current month is December 2001.

Working days are defined in calendar WORKDAYS, which contains the following
working days (indicated by Y) for December 2001:

---S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y

Periodic calendar PERIDAYS contains the following periodic definition for

December 2001. These examples assume that all other days of this calendar are
blank.

---S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
B C A A B B C A A B B C A A B B C A A B B

Start of the week is defined as Monday. Weeks start on the following dates in
December 2001: 3rd, 10th, 17th, 24th, and 31st.

614 CONTROL-D and CONTROL-V User Guide

 WDAYS: Basic Scheduling Parameter

At the end of each example, asterisks in a December 2001 calendar indicate the days
on which the mission is scheduled.

Example 1

Schedule the mission on every Sunday and Monday.

WDAYS 0,1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 330 WDAYS Parameter Example 1

Example 2

Schedule the mission on all working days and on all Saturdays.

WDAYS +6
WCAL WORKDAYS

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 331 WDAYS Parameter Example 2

Example 3

Schedule the mission on Sunday, if it is a working day. If Sunday is not a working

day, schedule the mission on the first preceding working day that is not a Friday.

WDAYS <0,-5
WCAL WORKDAYS

Chapter 3 Decollating Mission Parameters 615

WDAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 332 WDAYS Parameter Example 3

Example 4

Schedule the mission on the 1st Monday of the 1st week in the month.

WDAYS D1W1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 333 WDAYS Parameter Example 4

Example 5

Schedule the mission on all working days except Mondays and Fridays.

WDAYS -D1,-L1
WCAL WORKDAYS

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 334 WDAYS Parameter Example 5

Example 6

Each week, schedule the mission on the 1st day of period A in that week, and on all
days except the second day of period B in that week.

616 CONTROL-D and CONTROL-V User Guide

 WDAYS: Basic Scheduling Parameter

WDAYS D1PA,-D2PB
WCAL PERIDAYS

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 335 WDAYS Parameter Example 6

Example 7

Schedule the mission on each Monday and on the 1st day of the month.

DAYS 1
AND/OR OR
WDAYS 1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 336 WDAYS Parameter Example 7

Example 8

Schedule the mission on the 3rd day of the month only if it is a Monday.

DAYS 3
AND/OR AND
WDAYS 1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 337 WDAYS Parameter Example 8

Chapter 3 Decollating Mission Parameters 617

WDAYS: Basic Scheduling Parameter

Example 9

Schedule the mission on the last Monday of the month.

DAYS L1,L2,L3,L4,L5,L6,L7
AND/OR AND
WDAYS 1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 338 WDAYS Parameter Example 9

Example 10

Schedule the mission on the 1st, 7th and 15th day of the month if they are both
Saturdays and working days. If the day of the month (1st, 7th, 15th) is not a Saturday,
do not schedule the mission. If the day of the month is a Saturday, but it is not a
working day, schedule the mission on the next working day.

DAYS 1,7,15
AND/OR AND
WDAYS 6
CONFCAL WORKDAYS
SHIFT >

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 339 WDAYS Parameter Example 10

618 CONTROL-D and CONTROL-V User Guide

 WHEN: Decollating Parameter

WHEN: Decollating Parameter

Page identification criteria.

Figure 340 WHEN Parameter Format

Mandatory. Valid subparameters:

Table 240 WHEN Subparameters (part 1 of 5)

Subparameter Description
By default, the WHEN parameter displays the LINE and COL fields. You can switch
between these fields and the VAR field as described in discussion of the VAR subparameter
in this table.
LINE Line range that defines the STRING search area, comprised of:

line_from A 5-digit number from 00001 through 32768. When a

string is specified, this parameter is mandatory. Leading zeros
must be supplied. The usage of an asterisk in this field is
described below in General Information.

line_until A 5-digit number from 00001 through 32768 greater

than or equal to the from LINE value. When a string is
specified, this parameter is mandatory. Leading zeros must be
supplied.

Note: For ON TRNCLASS or ON TRNDSN the first digit of the

line number is set according to the orientation. For more
information see Creating a Text Report from the Print Stream
Report (Second Temporary Decollation Definition) on
page 813.

Chapter 3 Decollating Mission Parameters 619

WHEN: Decollating Parameter

Table 240 WHEN Subparameters (part 2 of 5)

Subparameter Description
COL Column range that defines the STRING search area, comprised of:

col_from A 5-digit number from 00001 through 32768. When a

string is specified, this parameter is mandatory. Leading zeros
must be supplied.

col_until A 5-digit number from 00001 through 32768, greater

than or equal to the from COL value and with sufficient
column range to contain the specified string. When a string is
specified, this parameter is mandatory. Leading zeros must be
supplied.
VAR A variable used in comparing a string, variable, or system variable
in the STRING subparameter. You can switch between the WHEN
LINE and WHEN VAR statements, as follows:

To change a WHEN LINE statement to a WHEN VAR

statement, type the % symbol in the WHEN LINE field, and
press Enter. The COL and PRINT fields are hidden.

To change a WHEN VAR statement to a WHEN LINE

statement, delete all characters from the WHEN VAR field, and
press Enter. The COL and PRINT fields are displayed.

A WHEN VAR statement can be used in conjunction with a WHEN

LINE statement connected by an AND/OR parameter.
PRINT Indicates whether to print the line containing the identifying string.
Valid values are:

Y (Yes) or blank Print the line containing the identifying

string. Default

N (No) Do not print the line containing the identifying string.

BMC Software recommends that you do not specify PRINT=N
if the identifying string contains logical comparison operator
.NE. (not equal to).
REF NXT Indicates whether STRING identifies the next or the current report
page. Valid values are:

Y (Yes) The identifying string refers to (and describes the

recipients of) the next page instead of the page on which it is
found.

N (No) or blank The identifying string refers to (and describes

the recipients of) the page on which it is found. Default.

620 CONTROL-D and CONTROL-V User Guide

 WHEN: Decollating Parameter

Table 240 WHEN Subparameters (part 3 of 5)

Subparameter Description
CT Continuous identification. Valid values are:

N (No) Every page must be identified. Default if REF NEXT

PAGE is set to N or blank. Pages that do not contain an
identifying string are directed to the default recipient.
Note: Options Y, E, and W, below, are intended for cases where the
identifying string does not appear on the page you want to
distribute (for example, it only appears on a header page).
Y (Yes) Continue identification to the next pages. Default if
REF NEXT PAGE is set to Y. Unidentified pages are directed to
the user identification obtained from the previous pages
under the same ON statement.

E (Ext.) Extended continuation. Continuous identification

takes effect across JES dataset boundaries. The entire job is
processed with continuous identification.

W (When) WHEN string continuation. Pages with no

identifying string are directed to the user identification
obtained from the previous page. If an identifying string is
present, but DO USER is set to * and no valid user name
appears on the page, the page is sent to the default user.

m Continue identification to the next pages, but check m

pages only. The identification string is checked in the first m
pages of each SYSOUT. The pages after the first m pages are
then routed, without page checking, to the user whose
identification was obtained from the previous pages under the
same ON statement in the same manner as a WHEN statement
with CONTID(CT)=Y.
Valid values for m are 1 through 9.
AND/OR Concatenation parameter. If specified, another WHEN line is
opened. Valid values are:

A (And) The page is identified only if both WHEN conditions

are true. Use this value when two or more distinct strings on the
report page are required to accomplish the identification.

O (Or) The page is identified if either of the WHEN conditions

is true. Use this value if the identification strings may reside in
more than one distinct area on the report page.

If both A and O are specified in the same WHEN statement, the

strings concatenated by A are evaluated first.

A WHEN VAR statement can be used in conjunction with a WHEN

LINE statement connected by an AND/OR parameter.

Chapter 3 Decollating Mission Parameters 621

WHEN: Decollating Parameter

Table 240 WHEN Subparameters (part 4 of 5)

Subparameter Description
STRING The identifying characters for which the search is performed. It may
be a constant or variable.

The constant STRING can be 1 through 50 characters.

The variable STRING can be a variable name, including the system

variables JOBNAME, EXTWTR, USERID, FILE, DSNLLQ, or
substrings of these variables.

If you need to use a longer identification string, enter A (And) in

parameter AND/OR and use another WHEN statement.

The string can contain blanks, single quotes and hex format. When
not enclosed in single quotes, the length of the string to be
compared is measured from the start of the field to the last
non-blank character.

Example:

STRING=' EMP '

STRING=x'hhhhhh'
STRING=%%vtitle

The WHEN statement STRING field can also contain logical

comparison operators. The format of the string when it contains
these operators is as follows:

STRING=[op-comp] {string| {%%var2 |

%%system_var}[(<startpos>,<length>)]}

where

op-comp is the comparison operator. Periods on both sides of the

operator are mandatory. An operator must start in the first
column of the STRING field. The following operators are
supported:
.GT.Greater than
.LT. Less than
.GE.Greater than or equal to
.LE. Less than or equal to
.EQ.Equal to
.GL. Not equal to
.NE. No matching value was found in the range. The line
for the next set of DO statements cannot be determined.

622 CONTROL-D and CONTROL-V User Guide

 WHEN: Decollating Parameter

Table 240 WHEN Subparameters (part 5 of 5)

Subparameter Description
STRING string is the string used for comparison. The string can contain
blanks, quotes and hexadecimal format.
(Continued) Examples:
STRING=' EMP '
STRING=X'hhhhhh'

var2 is the variable used for comparison

Example:
STRING=%%vtitle

system_var is a system variable used for comparison

startpos is the starting position of the substring to be extracted
length is the length of the substring to be extracted
Example:
STRING=%%vtitle(1,8)

General Information
The WHEN LINE and COLUMN range parameters specify the area on a report page
in which the identifying character string is located.

The parameters that immediately follow the WHEN line and column range on the
Report Decollating Definition screen provide additional page identification
instructions.

The following are further details of the WHEN subparameters:

Table 241 Further WHEN Subparameter Details (part 1 of 3)

Subparameter Description
LINE The range of lines on the page (from and to) within which the
character string search takes place.

The special line range 99999 is used to search the entire page as a
stream of data. This method is usually used when decollating a sysout
in Page Mode (as opposed to Line Mode). Page Mode is often used for
graphic reports and reports designed for laser printers. There is no
way to check for line range in Page Mode output.

If multiple WHEN statements are joined by concatenation parameter

A (And), an asterisk can be entered in parameter LINE of the second
and subsequent WHEN statements to specify that the required strings
are searched for in the same line in which the string required by the
first WHEN statement was found.

Chapter 3 Decollating Mission Parameters 623

WHEN: Decollating Parameter

Table 241 Further WHEN Subparameter Details (part 2 of 3)

Subparameter Description
COL The range of columns (from and to) within which the character string
search takes place.

The special column number 9999 is used to search an entire row. This
is useful for AFP format lines to search the entire line.
Note: It is possible to specify large search windows (for example, the
entire page or most of it). However, large search windows should
generally be used only in the early stages of report definition. It is
recommended to minimize the size of the search window (when
possible) for two reasons:

The identifying string may appear in a different part of the search

window unexpectedly, thereby causing incorrect report
distribution.
Performance is greatly improved, especially for large reports.
PRINT The value N is intended for cases where a site-developed report
distribution system has been used. Set PRINT to N if the identifying
string resides on a line which should not be included in the printed
report.
REF NXT This option is intended for special cases where the REF NXT
identification is set to Y, the CONTID default is Y.

624 CONTROL-D and CONTROL-V User Guide

 WHEN: Decollating Parameter

Table 241 Further WHEN Subparameter Details (part 3 of 3)

Subparameter Description
STRING The WHEN statement STRING field can contain logical comparison
operators. The format of the string when it contains these operators is
as follows:

STRING = [op_comp] {string| %%var2 |

%%system_var}[(<startpos>,<length>)]}

where

op_comp is the comparison operator. Periods on both sides of the

operator are mandatory. An operator must start in the first
column of the STRING field. The following operators are
supported:
.GT.Greater than
.LT. Less than
.GE. Greater than or equal to
.LE. Less than or equal to
.EQ. Equal to
.GL. Not equal to
.NE. No matching value was found in the range. The line for
the next set of DO statements cannot be determined.
string is the string used for comparison. The string can contain
blanks, quotes and hexadecimal format.
Examples:
STRING=' EMP '
STRING=X'hhhhhh'
var2 is the variable used for comparison
Example:
STRING=%%vtitle
system_var is a system variable used for comparison
startpos is the starting position of the substring to be extracted
length is the length of the substring to be extracted
Example:
STRING=%%vtitle(1,8)

When a page is identified by CONTROL-V, the DO statements specified under the

WHEN statement are activated for that page.

NOTE
A report may contain characters that cannot be displayed because they are not supported by
the terminal. Also, some characters appear different on the screen than in print (for example,
special characters on laser printers).

In such cases, you can use CONTROL-D Exit CTDX007 to perform character set
translations based on the contents of the string field. A special symbol in the string
field designates the use and name of the translation table. Using this method, you can
handle all the possible printing symbols, including graphics.

Chapter 3 Decollating Mission Parameters 625

WHEN: Decollating Parameter

Examples

Example 1

The identifying string resides between lines 1 and 5 and between columns 10 and 70.
The identifying string are printed, along with the rest of the page. The string
references the page on which it is located (not the following page). Each page must be
identified separately.

Figure 341 WHEN Parameter Example 1

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00005 COL 00010 - 00070 PRINT REF NXT CT AND/OR
STRING = E M P L O Y E E S R E P O R T
DO NAME = EMPLOYEES REPORT
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Example 2

Two identifying strings are required to fully identify the report. One string is on line
1. The other string is on line 3.

626 CONTROL-D and CONTROL-V User Guide

 WHEN: Decollating Parameter

Figure 342 WHEN Parameter Example 2

------- CONTROL-D/V CATEGORY DAILY JOB PLRPT010 ----------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
DEF COPIES 00 LVL 90 USER UNIDENT DEST MAX COPIES 05
===========================================================================
ON CLASS = D EXTWTR DEST FORM
PRT COPIES 01 LVL 20 USER MGT DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE 00001 - 00001 COL 00014 - 00046 PRINT Y REF NXT N CT N AND/OR A
STRING = E M P L O Y E E S R E P O R T
WHEN LINE 00003 - 00003 COL 00014 - 00132 PRINT Y REF NXT N CT N AND/OR
STRING = V A C A T I O N S
DO NAME = EMPLOYEES VACATIONS
DO USER = MANAGEMENT LVL LINE COL -
S A T SYNONYM = CONCAT =
DO USER = * LVL LINE COL 00064 - 00074
S A T SYNONYM = CONCAT =
DO PRINT = STD MUST =
DO BACKUP = BKP0031D
DO
WHEN LINE - COL - PRINT REF NXT CT AND/O
==========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 14.00.06

Example 3

The following is an example of using DO SET in conjunction with a WHEN VAR

statement:

WHEN LINE - COL - PRINT REF NXT CT AND/OR

STRING =
DO SET = %%VAR1 =REP 1 C CS
DO SET = %%VAR2 =X'0AFA0F40F2' C CS
DO SET = %%VAR3 ='REP 2' C CS
DO
WHEN VAR %%VAR2 REF NXT CT AND/OR A
STRING = %%VAR3
WHEN LINE 00003 - 00003 COL 00034 - 00050 PRINT REF NXT CT AND/OR A
STRING = .NE.%%VAR2
WHEN VAR %%VAR2 REF NXT CT AND/OR
STRING = .NE.'REP '

Chapter 3 Decollating Mission Parameters 627

WHEN IN QUEUE/CLS: Runtime Scheduling Parameter

WHEN IN QUEUE/CLS: Runtime Scheduling

Parameter
Flag and output class parameters that determine where CONTROL-V should look to
find the job whose reports should be decollated.

Figure 343 WHEN IN QUEUE/CLS Parameter Format

Optional. Includes the following subparameters:

Table 242 WHEN IN QUEUE/CLS Subparameters

Subparameter Description
WHEN IN QUEUE Determines whether the output queue are searched for the job to be
decollated. Valid values are:

Y Search for the job in the output queue. Default.

E Search for the job in the output queue. Include currently
executing jobs in the search.
N Do not search for the job in output queue.
S Search for the job in the output queue, using as selection
criteria parameters defined in all ON CLASS or ON TRNCLASS
statements (CLASS, EXTWTR, DEST, FORM).
CLS Any valid non-held output class. If CLS is specified, a decollating
mission does not start unless some output from the job is currently in
the specified class.

When parameter WHEN IN QUEUE=S, CLS is not necessary.

General Information
WHEN IN QUEUE=Y (or E or S) instructs CONTROL-V to search for the job in the
output queue. Decollation takes place only if the job is found in the output queue or,
when this parameter is set to E, the job is currently executing or in the output queue.

628 CONTROL-D and CONTROL-V User Guide

 WHEN IN QUEUE/CLS: Runtime Scheduling Parameter

If two or more jobs which have the same name and which have not yet been
decollated are found, CONTROL-V selects the job that most recently finished
executing.

When the same job is run a few times a day, CONTROL-V does not decollate the
same job twice unless specified by the user. For more information, see Rerun
Option on page 321.

WHEN IN QUEUE=E can be used for decollation of files generated by continuous

jobs such as CICS or SYSLOG. WHEN IN QUEUE=Y can be used for decollation of
cyclic missions.

WHEN IN QUEUE=N instructs CONTROL-V not to search for the job in the output
queue. WHEN IN QUEUE=N starts the decollating of compressed datasets based on
the prerequisite conditions specified in the IN parameter. Therefore, do not use this
option without specifying prerequisite conditions in an IN parameter.

Specifying appropriate values for WHEN IN QUEUE and CLS can help prevent the
decollation of output which should not be decollated.

WHEN IN QUEUE=S is used as a selection parameter for an activation decollation

mission. It forces missions to search SYSOUTs created by jobs in a non-HELD class
that match parameters defined in ON CLASS/ON TRNCLASS statements.
Decollation begins only if such a SYSOUT is found in the non-HELD output queue.
Once such mission is started, it will process all SYSOUTs from HELD and non-HELD
classes that match ON statements.

This mode enables the number of ENQs activated under the decollation monitor to
remain low. Defining WHEN IN QUEUE=S in a decollation mission removes
ENQ ioaqname CTDREP-jobname jobid, if no SYSOUT from HELD classes was
decollated.

This occurs in the following cases:

Optional wish WD2552 is applied. SYSOUTs from HELD classes are not decollated
by any DECOLLATION mission.

The corresponding job does not create SYSOUTs in HELD classes.

Selection criteria from all ON statements (ON CLASS, ON TRNCLASS, ON

SYSOUT) do not refer to a SYSOUT in a HELD class.

If ioaqname CTDREP-jobname jobid ENQs are removed when a decollation

mission with WHEN IN QUEUE=S finishes processing, it means that another
decollation mission is able to process SYSOUTs created by a job with the same JOBID,
if these SYSOUTs were not processed by a previous decollation mission.

Chapter 3 Decollating Mission Parameters 629

WHEN IN QUEUE/CLS: Runtime Scheduling Parameter

Example 1
The job creates compressed datasets. Decollating of the compressed sysout is
triggered by the prerequisite condition SALARY-OK.

Figure 344 WHEN IN QUEUE/CLS Example 1

---- CONTROL-D/V CATEGORY DAILY JOB SLRPT001 ------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME SLRPT001 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP SL-PRODUCTION JOBID
DESC SALARY REPORTS
DESC
===========================================================================
DAYS 01,15 DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 06
MINIMUM PDS
===========================================================================
IN SALARY-OK ODAT
WHEN IN QUEUE N CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 08.43.06

Example 2
This job decollates the output of a cyclic job. The decollating mission does not begin
until a SYSOUT file exists in output class X.

Figure 345 WHEN IN QUEUE/CLS Example 2

----- CONTROL-D CATEGORY PERSONNEL JOB ONDUTYC ----------- (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
IN
WHEN IN QUEUE Y CLS X TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
===========================================================================
DEF COPIES LVL USER DEST MAX COPIES
===========================================================================
ON CLASS = X
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =

630 CONTROL-D and CONTROL-V User Guide

 WHEN IN QUEUE/CLS: Runtime Scheduling Parameter

DO USER = PROD LVL LINE COL -

S A T SYNONYM = CONCAT =
DO NAME = ODROSTER
DO PRINT = ODRPRT MUST =
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 16.05.20

Example 3
This decollating mission processes a SYSOUT created by job SLRPS001. The
decollating mission does not begin until job SLRPS001 creates a SYSOUT file in class
E with destination R1234. If job SLRPS001 does not create the required SYSOUT, the
decollation will be left in status WAITING FOR JOB until the required SYSOUT file is
created.

Figure 346 WHEN IN QUEUE/CLS Example 3

---- CONTROL-D/V CATEGORY DAILY JOB SLRPS001 ------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME SLRPS001 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP SL-PRODUCTION JOBID
DESC SALARY REPORTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE S CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
===========================================================================
DEF COPIES LVL USER DEST MAX COPIES
===========================================================================
ON CLASS = E EXTWTR DEST R1234 FORM
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO USER = PROD LVL LINE COL -
S A T SYNONYM = CONCAT =
DO NAME = ODROSTER
DO PRINT = ODRPRT MUST =
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH, CAPS 16.05.20

Chapter 3 Decollating Mission Parameters 631

WHEN IN QUEUE/CLS: Runtime Scheduling Parameter

Example 4
If the job SLRPS001 creates two SYSOUTs, one in class E with destination R1234 and
another in class X with destination R5678, these two SYSOUTs can be processed by
two decollation missions, the first SYSOUT by the mission from Example 3, and the
second by the following decollation mission:

Figure 347 WHEN IN QUEUE/CLS Example 4

---- CONTROL-D/V CATEGORY DAILY JOB SLRPS001 ------(R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY JOBNAME SLRPS001 GENERIC N MONITOR
OWNER M22 TASKTYPE REP GROUP SL-PRODUCTION JOBID
DESC SALARY REPORTS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
WHEN IN QUEUE S CLS TIME FROM UNTIL INTERVAL PRIORITY
DSN
===========================================================================
OUT
SHOUT WHEN TO URG
MSG
===========================================================================
DEF COPIES LVL USER DEST MAX COPIES
===========================================================================
ON CLASS = X EXTWTR DEST R5678 FORM
PRT COPIES LVL USER DEST MAX COPIES
PRINT/CDAM PARMS =
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO USER = PROD LVL LINE COL -
S A T SYNONYM = CONCAT =
DO NAME = ODROSTER_X_R5678
DO PRINT = ODRPRT MUST =
DO
WHEN LINE - COL - PRINT REF NXT CT AND/OR
STRING =
DO
===========================================================================
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH, CAPS 16.05.20

632 CONTROL-D and CONTROL-V User Guide

 Chapter

4
Migration, Printing, Backup and
4

Restore Mission Parameters

This chapter contains the following topics:

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635
Parameter Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639
General Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641
Bundling Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
Basic Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 642
Runtime Scheduling Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
Post-Processing Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645
Mission-Specific Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646
Parameter Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647
# OF DAYS TO KEEP: Mission Specific Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . 648
# OF GENERATIONS TO KEEP: Mission specific Parameter . . . . . . . . . . . . . . . . . . 650
BATCH: Mission Specific Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
CATEGORY: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654
CENTERA RETENTION CLASS: Mission-specific Parameter . . . . . . . . . . . . . . . . . . 657
CONFCAL: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 659
DATES: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662
DAYS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 664
DESC: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 674
GROUP: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676
IN: Runtime Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 679
INCLUDE/EXCLUDE USER: Printing Mission Bundling Parameter . . . . . . . . . . . . 682
INTERVAL: Runtime Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684
MAXWAIT: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 686
MINIMUM: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689
MISSION: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 691
MONITOR: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 693
MONTHS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695
NOT LATER THAN: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . 697
ON LINE# : Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 699
ON PAGE# : Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
OUT: Post-processing Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 702

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 633

 OVERRIDE: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
OWNER: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708
PDS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 710
PRINTER: Mission-specific Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 712
PRIORITY: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 715
RETENTION DAYS: Mission-specific Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 717
RETRO: Basic Scheduling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719
SECONDARY SKELETON: Mission-specific Parameter . . . . . . . . . . . . . . . . . . . . . . . 722
SHOUT: Post-Processing Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724
SORT: Printing Mission Bundling Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729
STAGE: Mission-specific Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733
STORE: Mission-specific Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736
TASKTYPE: General Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 738
TIME: Runtime Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 741
TIMEOUT: Mission-specific Parameter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 744
WDAYS: Basic Scheduling Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 746

634 CONTROL-D and CONTROL-V User Guide

 Overview

Overview
Migration, printing, backup and restore mission parameters are used to define rules
and operating instructions for executing these missions under CONTROL-V.

Separate Mission Definition screens exist for each of these missions. However, many
of the parameters are common to all the screens and operate in a similar manner,
regardless of the type of mission being defined. This chapter describes these
parameters and their usage.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 635

Overview

Migration, printing, backup and restore mission parameters are defined via the
Online facility using preformatted screens.

Figure 348 Migration Mission Definition Screen

---- CONTROL-V CATEGORY MIGLIM MIG MISSION MIGLIM --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
| CATEGORY MIGLIM MISSION MIGLIM |
| OWNER N16A TASKTYPE MIG GROUP |
| DESC |
| =========================================================================== |
| STAGE 01 SCHEDULING PARAMETERS |
| DAYS DCAL |
| AND/OR |
| WDAYS WCAL |
| MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y |
| DATES |
| CONFCAL SHIFT RETRO N MAXWAIT 00 |
| MINIMUM PDS |
| =========================================================================== |
| IN |
| TIME FROM TO NOT LATER THAN PRIORITY |
| =========================================================================== |
| OUT |
| SHOUT WHEN TO URGN |
| MSG |
| =========================================================================== |
| RETENTION DAYS 03000 FORCE N SECONDARY SKELETON MICLIM |
CENTERA RETENTION CLASS Class1
| =========================================================================== |
| STAGE 01 PRIMARY MEDIA DISK AGE 00001 REFRESH CTLG |
| PREFIX |
| SECONDARY MEDIA CART REFRESH CTLG |
| =========================================================================== |
| MIGRATION PATH SCHEDULING PARAMETERS |
| DAYS DCAL |
| AND/OR |
| WDAYS WCAL |
| MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y |
| DATES |
| CONFCAL SHIFT RETRO N MAXWAIT 00 |
| MINIMUM PDS |
| =========================================================================== |
| IN |
| TIME FROM TO NOT LATER THAN PRIORITY |
| =========================================================================== |
| OUT |
| SHOUT WHEN TO URGN |
| MSG |
| =========================================================================== |
| STAGE 02 PRIMARY MEDIA CENTERA AGE 00030 REFRESH 01000 CTLG |
| SECONDARY MEDIA CART REFRESH 01000 CTLG N |
| STAGE 03 PRIMARY MEDIA AGE REFRESH CTLG |
| SECONDARY MEDIA REFRESH CTLG |
| =========================================================================== |
======= >>>>>>> END OF BACKUP MISSION PARAMETERS OF THIS CATEGORY <<<<<< =====

636 CONTROL-D and CONTROL-V User Guide

 Overview

Figure 349 Printing Mission Definition Screen

---- CONTROL-D CATEGORY DAILY PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===>CRSR
+--------------------------------------------------------------------------- --+
CATEGORY DAILY MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP
BATCH N SKELETON FREE CLOSE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC PRINTING MISSION FOR ALL STANDARD FORM REPORTS
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ :
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN OP-START-PRINT-STD ODAT
TIME FROM TO NOT LATER THAN PRIORITY
ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG PRINTING MISSION STD ENDED NOTOK
SHOUT WHEN TO URGN
MSG
PRINTER DEST CHUNKSIZE
ON FORM
REQUEST
======= >>>>>>> END OF PRINTING MISSION PARAMETERS OF THIS CATEGORY <<<<<< ====
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 13.13.53

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 637

Overview

Figure 350 Backup Mission Definition Screen

---- CONTROL-D CATEGORY DAILY BKP MISSION BKP0031D --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION BKP0031D
OWNER M22 TASKTYPE BKP GROUP DAILY-BKP
DESC BACKUP REPORTS FOR 31 DAYS
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN OP-START-BACKUP-031D
TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
# OF DAYS TO KEEP 00031 # OF GENERATIONS TO KEEP
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG BACKUP MISSION BKP0031D ENDED NOTOK
SHOUT WHEN TO URGN
MSG
======= >>>>>>> END OF BACKUP MISSION PARAMETERS OF THIS CATEGORY <<<<<< ======
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 10.20.51

Figure 351 Restore Mission Definition Screen

---- CONTROL-D CATEGORY DAILY RST MISSION RSTADHOC --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION RSTADHOC
OWNER M22 TASKTYPE RST GROUP DAILY-RST
DESC AD-HOC RESTORE MISSION
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN OP-START-RESTORE-ADH ODAT
TIME FROM TO NOT LATER THAN PRIORITY INTERVAL
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG RESTORE MISSION RSTADHOC ENDED NOTOK
SHOUT WHEN TO URGN
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 10.22.31

BMC Software recommends that before proceeding with this chapter, all
CONTROL-V users read Migration, Printing, Backup, Restore Mission Definition
Facility on page 140.

638 CONTROL-D and CONTROL-V User Guide

 Parameter Types

Mission parameters only need to be defined once for each mission. CONTROL-V uses
these parameters for numerous executions of the same mission at different times. Of
course, CONTROL-V lets you modify the parameters at any time.

All parameter definitions are stored as members in standard user libraries. One
member must exist for each mission and the member name must be identical to the
mission name. Each mission is composed of operating instructions for one or more
different mission categories (for example, MIGR-1YEAR, MIGR-5YEARS).
Maintenance within the library and management of the mission operating
instructions are carried out using the Online Mission Definition facility.

This chapter contains a description of the instructions for a single mission category.

Parameter Types
The following types of mission parameters can be specified:

1. What to do?
General Parameters specify which mission to run, the mission type (regular,
emergency, cyclic), and so on. Parameters include:

CATEGORY
DESC
GROUP
MISSION
OWNER
TASKTYPE

2. Bundling.
Bundling Parameters (for printing missions only) determine the recipients and the
sequence of reports in each bundle. Parameters include:

EXCLUDE USER
INCLUDE USER
SORT

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 639

Parameter Types

3. When?
Basic Scheduling Parameters specify the day or time to execute the mission.
Parameters include:

CONFCAL
DATES
DAYS
MAXWAIT
MINIMUM
MONTHS
PDS
RETRO
WDAYS

4. Runtime Environment.
Runtime Scheduling Parameters specify requirements that must be satisfied to
execute the mission. Parameters include:

IN
INTERVAL
NOT LATER THAN
ON LINE# (available in a future version)
ON PAGE#
PRIORITY
TIME

5. Results Control.
Post-processing Parameters specify what to do when the mission finishes
processing (OK or NOTOK). Parameters include:

OUT
SHOUT

640 CONTROL-D and CONTROL-V User Guide

 General Parameters

6. Mission-specific
Mission-specific Parameters are unique for each type of mission. Parameters
include:

# OF DAYS TO KEEP
# OF GENERATIONS TO KEEP
BATCH
MONITOR
ON FORM (available in a future version)
OVERRIDE
PRINTER
REQUEST (available in a future version)
RETENTION DAYS
CENTERA RETENTION CLASS
SECONDARY
STAGE
TIMEOUT

A brief summary of the parameters in each type is provided below. This is followed
by a detailed description of each parameter in alphabetical order.

General Parameters
CONTROL-V General parameters for migration, printing, backup and restore
missions specify which mission to run, the mission type (regular, cyclic, emergency),
the owner of the mission (for security purposes), and so on.

The following General parameters are described in this chapter:

Table 243 CONTROL-V General Parameters

Parameter Description
CATEGORY Category of the mission parameters (for example, DAILY, MONTHLY,
WORKDAY).
MISSION Name of the migration, printing, backup or restore mission.
OWNER User ID of a user who requests CONTROL-V services (for security
purposes)
TASKTYPE Type of mission to be performed (such as PRT or EPR).
GROUP Descriptive name for a group of missions.
DESC Description of the mission (free text).

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 641

Bundling Parameters

Bundling Parameters
CONTROL-V Bundling parameters define the users whose reports are included or
excluded from the bundle and determine the criteria used for sorting the reports in a
bundle.

NOTE
Bundling parameters are applicable to printing missions only.

The following Bundling parameters are described in this chapter:

Table 244 CONTROL-V Bundling Parameters

Parameter Description
INCLUDE Name of the user whose reports (and whose childrens reports) are
USER included in the bundle.
EXCLUDE Name of the user whose reports (and whose childrens reports) are not
USER included in the bundle.
SORT Bundle sort parameters.

Basic Scheduling Parameters

Basic Scheduling parameters determine on which day a mission is scheduled in
(ordered to) the Active Missions file.

The New Day procedure determines whether the mission is a candidate for execution
on a specific date. If a mission is a candidate for execution on a specific date, the
mission is placed in the Active Missions file.

Each mission in the Active Missions file has an original scheduling date associated
with it. This is the date the mission should execute according to the Basic Scheduling
parameters. This date is not necessarily the same as the current system date or
working date.

Basic Scheduling parameters are defined separately for MIG and MSM migration
missions:

STAGE 01 SCHEDULING PARAMETERS specify scheduling criteria for the initial

migration (MIG migration) from disk to another media. Only the Active User
Reports file is scanned to locate reports that should be migrated by MIG migration.

642 CONTROL-D and CONTROL-V User Guide

 Basic Scheduling Parameters

MIGRATION PATH SCHEDULING PARAMETERS specify scheduling criteria for

all subsequent migrations (MSM migration). Only the Migrated User Reports file is
scanned to locate reports that should be migrated by MSM migration.

For more information on this topic, see MIG and MSM Migration Types and
Scheduling Criteria in the CONTROL-D and CONTROL-V chapter of the
INCONTROL for z/OS Administrator Guide.

NOTE
Basic Scheduling parameters may be ignored by the CONTROL-V New Day procedure,
depending on the mode of operation.

Basic Scheduling parameters are divided into the four groups listed below.
Parameters must be selected from only one of the first three groups (A, B or C). Use of
the fourth group (D) is optional.

Table 245 Basic Scheduling Parameter Groups

Group Parameter Description
A DAYS Days of the month to activate the mission.
WDAYS Days of the week to activate the mission Sunday, Monday,
and so on.
MONTHS Months to activate the mission.
CONFCAL Name of a user-defined calendar used for confirming schedule
dates.
B DATES Specific dates in the year (day and month) to activate the
mission.
C PDS Name of a partitioned dataset (library) to be checked for
minimum free space.
MINIMUM Minimum number of free tracks required for the library
defined in parameter PDS.
D RETRO Indicator that specifies whether or not the mission should be
scheduled for execution after its original scheduling date has
passed.
MAXWAIT Maximum number of days a mission should remain available
for execution after its original scheduling date has passed.

Each Basic Scheduling parameter is described in this chapter. However, the

interrelationships between some of these parameters are described briefly below.

DAYS/DCAL WDAYS/WCAL
All these parameters are optional.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 643

Basic Scheduling Parameters

Parameter DAYS identifies days of the month on which the mission should be
scheduled (for example, 1st day of the month, 3rd working day of the month). Several
formats are available for specifying DAYS values.

Parameter WDAYS identifies days of the week on which the mission should be
scheduled (for example, the 1st day of the week, the 2nd working day of each week).
Several formats are available for specifying WDAYS values.

A calendar name can be specified in the DCAL and/or WCAL fields. A calendar
specifies working daysdays of the year on which a mission can be scheduled.
Calendars and the IOA Calendar facility are discussed in
Chapter 2.

When both DAYS and DCAL are specified, they work as a complementary unit, as
described later in this chapter. Similarly, when both WDAYS and WCAL are
specified, they also work as a complementary unit, as described later in this chapter.

When values for both DAYS (/DCAL) and WDAYS (/WCAL) are specified in the
same mission, the resulting schedule is determined by the value specified in field
AND/OR.

CONFCAL/SHIFT
A calendar specified in CONFCAL is not used for mission scheduling but is used
instead for validating a scheduled date. Only missions which have satisfied all other
specified basic scheduling criteria are checked against the CONFCAL calendar. If the
day is a working day in the CONFCAL calendar, the mission is scheduled on that
day. Otherwise, the mission is either shifted to (scheduled on) another day according
to the value specified in parameter SHIFT, or the mission is not scheduled (if no
SHIFT value has been specified).

CONFCAL calendars are useful for handling holidays and other scheduling
exceptions.

Defining a Schedule Internal Scheduling Logic

When defining missions, it is useful to understand the IOA Scheduling facility logic
which determines whether or not to order a mission on a specific day. This logic is
described below.

1. DAYS/DCAL parameters are checked independently and a first tentative

scheduling decision is created.

2. WDAYS/WCAL parameters are also checked independently and a second

tentative scheduling decision is created.

644 CONTROL-D and CONTROL-V User Guide

 Runtime Scheduling Parameters

3. A third tentative scheduling decision is created based on the above two decisions
and the AND/OR value linking them.

If DAYS/DCAL are not specified, this third scheduling decision is identical to the
second scheduling decision. If WDAYS/WCAL are not specified, this third
scheduling decision is identical to the first scheduling decision.

4. If CONFCAL/SHIFT are specified, the third scheduling decision is adjusted

according to the CONFCAL/SHIFT criteria.

5. This third decision (as adjusted) becomes the final scheduling decision. The IOA
Scheduling facility determines whether or not to schedule a mission based on this
final scheduling decision.

Runtime Scheduling Parameters

The CONTROL-V monitor determines whether or not the requirements for running
the mission are satisfied. If they are, the mission can be executed.

The following Runtime Scheduling parameters are described in this chapter:

Table 246 Runtime Scheduling Parameters

Parameter Description
IN Prerequisite conditions for the execution of the mission.
TIME Time of day limits (FROM, TO) for executing the mission.
NOT LATER THAN Time by which the mission starts executing even if other
prerequisite conditions are not satisfied.
PRIORITY Mission priority (compared to other missions).
ON PAGE # The threshold number of pages that triggers (initiates execution of)
a printing mission.
ON LINE # For future use.
INTERVAL For cyclic restore or printing missions only: minimum time to wait
between each restore or print.

Post-Processing Parameters
Post-processing parameters define actions to be taken after the mission has finished
executing. The two post-processing parameters are:

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 645

Mission-Specific Parameters

Table 247 Post-Processing Parameters

Parameter Description
OUT Defines a list of prerequisite conditions to be added or deleted after
the mission finishes executing OK. These prerequisite conditions can
be referred to by IN statements of other missions.
SHOUT Specifies messages to be sent to specified destinations upon the
occurrence of specific events. Currently only OK, NOTOK and LATE
are supported.

Various internal CONTROL-V rules are applied to determine whether or not the
mission ended OK. Events which may cause a NOTOK indication include:

A CDAM file is missing for a report being printed or backed up.

An error occurred while accessing the Active User Report file during a printing
mission or backup mission.

There are many other events which can cause a NOTOK status (such as spool I/O
error). When a NOTOK status is encountered, use the L (Log) option of the
CONTROL-V Active Missions screen to receive a list of reasons for the NOTOK
status.

Mission-Specific Parameters
Mission-specific parameters are unique for each type of mission. Parameters
PRINTER, BATCH, MONITOR, OVERRIDE, and TIMEOUT apply to printing
missions only. The RETENTION DAYS, CENTERA RETENTION CLASS,
SECONDARY SKELETON, and STAGE parameters apply to migration missions
only. The # OF DAYS TO KEEP and # OF GENERATIONS TO KEEP parameters
apply to backup missions only.

Table 248 Mission-Specific Parameters (part 1 of 2)

Parameter Description
BATCH Enables a printing mission to be run as a batch job.
MONITOR Number that identifies the print monitor for a printing mission.
OVERRIDE Supersedes the corresponding Class, Destination, External writer
and Form values obtained during the decollation process.
PRINTER Logical name and JES destination of the printers on which the
mission can print and number of lines per chunk to be sent to
the printer.
RETENTION DAYS Number of days to keep the output of a migration mission.
SECONDARY Specifies the name of the secondary migration skeleton if a
SKELETON second copy of migration files is wanted.

646 CONTROL-D and CONTROL-V User Guide

 Parameter Descriptions

Table 248 Mission-Specific Parameters (part 2 of 2)

Parameter Description
CENTERA RETENTION Retention class defined in the EMC Centera storage system.
CLASS
STAGE Specifies the target media name, the report age when migration
occurs, the cyclic interval for refresh operations, and the prefix
for the target media.
STORE Yes/No indicator that specifies whether or not a new copy of the
report should be created and stored as a new report file with
embedded print resources.
TIMEOUT Number of minutes within which a printing mission must begin
execution.
# OF DAYS TO KEEP Number of days to keep the output of a backup mission.
# OF GENERATIONS TO Number of generations of backup mission output to keep.
KEEP
ON FORM For future use.
REQUEST For future use.

Parameter Descriptions
The following pages contain detailed descriptions of all parameters available in the
CONTROL-V Migration, Printing, Backup and Restore Mission screen. Parameters
are arranged in alphabetical order. Within each parameter, subparameters are
arranged according to the order of the fields on the screen.

Parameters which operate in a similar manner for printing, backup and restore
missions are presented only once. If a parameter only applies to a particular mission
type, this is indicated.

Each parameter begins on a new page, including:

A brief explanation of the parameters purpose.

The format required for defining the parameter within an extract of the
CONTROL-V screen.

General information explaining the parameter and its usage.

Where applicable, some practical examples illustrating implementation of the

parameter.

For more information on the Migration, Printing, Backup, and Restore Mission
facility, see Migration, Printing, Backup, Restore Mission Definition Facility on
page 140.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 647

# OF DAYS TO KEEP: Mission Specific Parameter

# OF DAYS TO KEEP: Mission Specific

Parameter
Number of days to keep the archived reports of backup missions.

Figure 352 # OF DAYS TO KEEP Parameter Format

# OF DAYS TO KEEP or # OF GENERATIONS TO KEEP, but not both, must be

specified.

NOTE
This parameter applies to backup missions only.

This parameter specifies a 5-digit number from 00001 through 65535. Leading zeros
must be supplied.

General Information
This parameter specifies the length of time the backup should be retained. A nonzero
value must be specified for either # OF DAYS TO KEEP or # OF GENERATIONS TO
KEEP, but not both.

NOTE
For information about requirements and restrictions when changing from # OF
GENERATIONS TO KEEP to # OF DAYS TO KEEP, see the CONTROL-D and CONTROL-V
chapter of the INCONTROL for z/OS Administrator Guide.

Utility CTDCLHIS produces a list of all backups whose # OF DAYS has expired.
These out of date backups are then automatically deleted or uncataloged.

648 CONTROL-D and CONTROL-V User Guide

 # OF DAYS TO KEEP: Mission Specific Parameter

Utility CTDUPBKP can be used to update the number of generations of report

backups and backup volume serial numbers in History and Active User files. For
information about utility CTDUPBKP, see the INCONTROL for z/OS Utilities Guide.

Example
Keep the backup created by this backup mission for 90 days.

Figure 353 # OF DAYS TO KEEP Parameter Example

---- CONTROL-D CATEGORY DAILY BKP MISSION BKP0014D --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION BKP0014D
OWNER M22 TASKTYPE BKP GROUP DAILY-BKP
DESC BACKUP REPORTS FOR 14 GENERATIONS
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN OP-START-BACKUP-014D ODAT
TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
# OF DAYS TO KEEP 00090 # OF GENERATIONS TO KEEP
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 12.53.58

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 649

# OF GENERATIONS TO KEEP: Mission specific Parameter

# OF GENERATIONS TO KEEP: Mission specific

Parameter
Number of generations of report backups produced by the backup mission to keep.

Figure 354 # OF GENERATIONS TO KEEP Parameter Format

# OF DAYS TO KEEP or # OF GENERATIONS TO KEEP, but not both, must be

specified for backup missions.

NOTE
This parameter applies to backup missions only.

This parameter specifies a 4-digit number from 0001 through 9999. Leading zeros
must be supplied.

General Information
Parameter # OF GENERATIONS TO KEEP specifies the number of generations of
report backups that should be retained. A nonzero value must be specified for either
# OF DAYS TO KEEP or # OF GENERATIONS TO KEEP, but not both.

NOTE
For information about requirements and restrictions when changing from # OF
GENERATIONS TO KEEP to # OF DAYS TO KEEP, see the CONTROL-D and CONTROL-V
chapter of the INCONTROL for z/OS Administrator Guide.

Utility CTDCLHIS produces a list of backups that fall outside the range of
generations to keep. These out of date backups are then automatically deleted or
uncataloged.

650 CONTROL-D and CONTROL-V User Guide

 # OF GENERATIONS TO KEEP: Mission specific Parameter

Utility CTDUPBKP can be used to update the retention period and backup volume
serial numbers in History or Active User Report files. For information about utility
CTDUPBKP, see the INCONTROL for z/OS Utilities Guide.

Example
Keep the backup created by this backup mission for 14 generations.

Figure 355 # OF GENERATIONS TO KEEP Parameter Example

---- CONTROL-D CATEGORY DAILY BKP MISSION BKP0014G --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION BKP0014G
OWNER M22 TASKTYPE BKP GROUP DAILY-BKP
DESC BACKUP REPORTS FOR 14 GENERATIONS
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN OP-START-BACKUP-014G ODAT
TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
# OF DAYS TO KEEP # OF GENERATIONS TO KEEP 00014
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 12.53.58

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 651

BATCH: Mission Specific Parameter

BATCH: Mission Specific Parameter

Yes/No indicator that specifies whether a printing mission is submitted as a subtask
of a print monitor or as a batch job. For batch jobs, the skeleton job member and the
sysout unallocation mode are also specified.

Figure 356 BATCH Parameter Format

NOTE
This parameter applies to printing missions only.

Table 249 BATCH Subparameters

Subparameter Description
BATCH Optional. Valid values are:

N (No)Printing mission is submitted as a subtask of the print

monitor. Parameters SKELETON and FREE are ignored. Default.

Y (Yes)Printing mission is submitted as a batch job. If parameter

PRTMON# is set to 0 in the CONTROL-D installation parameters,
no print monitors are started and parameter BATCH must be set
to Y.

If BATCH=Y, parameters SKELETON and FREE are relevant:

SKELETON Name of an existing member in the CONTROL-D SKL library.
Mandatory if BATCH is set to Y.
FREE Sysout allocation mode. Determines when sysout files is freed.
Optional. Valid values are:

CLOSEFree sysout files as soon as they are printed. Default.

ENDDo not free sysout files until the end of the job. This value is
only available if BATCH is set to Y.

652 CONTROL-D and CONTROL-V User Guide

 BATCH: Mission Specific Parameter

General Information
Parameter BATCH enables a printing mission to be scheduled and printed under a
batch job. If BATCH is set to Y, parameter MONITOR is ignored.

When BATCH is set to Y, a printing mission is processed and scheduled like a backup
or restore mission. The member specified in parameter SKELETON is read from the
CONTROL-V SKL library to obtain the skeleton JCL for the batch printing job. For
more information, see the CONTROL-D and CONTROL-V chapter of the
INCONTROL for z/OS Administrator Guide.

Example
This printing mission is submitted as a batch job using the JCL in member PRTSKL of
the CONTROL-D SKL library. Sysout files is freed as soon as they are printed. If the
printing mission does not begin executing within 15 minutes after it is submitted, the
mission terminates NOTOK.

Figure 357 BATCH Parameter Example

---- CONTROL-D CATEGORY STD PRT MISSION PRT1 --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY STD MISSION PRT1 MONITOR
OWNER M33B TASKTYPE PRT GROUP
BATCH Y SKELETON PRTSKL FREE CLOSE TIMEOUT 15
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ :
===========================================================================
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
===========================================================================
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.04.30

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 653

CATEGORY: General Parameter

CATEGORY: General Parameter

Category of the mission.

Figure 358 CATEGORY Parameter Format

Mandatory. The CATEGORY parameter specifies a category name of 1 to 20

characters. Only trailing blanks are allowed.

General Information
Parameters for each mission can be specified under different categories. It is possible
to use different criteria for different scheduling dates (for example, regular workday
vs. end of month). Each set of mission criteria is called a category.

Any number of categories (criteria) can be defined for each mission. It is possible to
use multiple categories of the same name, although this is usually not desirable. It is
recommended that in early stages of CONTROL-V implementation, only one basic
category be used for all backup or restore missions, such as DAILY.

For printing missions, parameter CATEGORY can specify the delivery method. For
example, a category can be established for each courier or for each specific bundle.
Parameter INCLUDE/EXCLUDE USER enables you to select the reports included in
each mission category.

For backup and migration missions, if the CATEGORY field is set to NOWAIT,
CONTROL-D does not synchronize mission processing and decollation processing,
and it does not back up or migrate CDAM files that were decollated after
CONTROL-D monitors were started.

For backup and migration missions, if the CATEGORY field is set to NOINDEX,
CONTROL-V indexes are not backed up or migrated together with the CDAM file. In
this case, the original Index files are deleted from DASD by the CTDDELRP utility
even if they are defined as RESIDENT.

654 CONTROL-D and CONTROL-V User Guide

 CATEGORY: General Parameter

For restore missions, if the CATEGORY field is set to

MIG=<migration mission name>, reports restored from the History User file will
then be picked up for migration by the specified migration mission. The reports
restored by a restore mission with the CATEGORY field set to any other value cannot
be migrated after restoring.

The following are some specific strings you can specify in the CATEGORY field for
printing missions, and their effect:

If you specify NOBANNER in the CATEGORY field, banner printing for this print
mission is suppressed. NOBANNER can be specified anywhere in the CATEGORY
field.

If you specify NORULER in the CATEGORY field, print rulers are not processed
for the mission and the Active User Report file is not searched to determine if a
ruler exists for the mission.

NORULER can be specified anywhere in the CATEGORY field. For example,

specifying NOBANNER, NORULER causes banners to not be printed and rulers to
not be used.

If you specify SEQL-FILE or SEQL=filename in the CATEGORY field, printouts are

written to the designated sequential file instead of the JES spool. For details, see the
CONTROL-D and CONTROL-V chapter of the INCONTROL for z/OS Administrator
Guide.

If the CATEGORY field begins with ASIS, machine control codes are not
translated to ASA codes and the original format and the original length of the
records that make up the report are saved while printing the report. This increases
the number of chunks but may be necessary for some XEROX or AFP reports.

Whenever the mission is scheduled, the specified category is placed in the Active
Missions file.

Example
Reports printed by this printing mission category is delivered by the courier to the
airport. Reports belonging to Dallas Bank and Dallas Insurance is included.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 655

CATEGORY: General Parameter

Figure 359 CATEGORY Parameter Example

---- CONTROL-D CATEGORY AIRPORT COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY AIRPORT-COURIER MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP DAILY-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC BUNDLE FOR DELIVERY VIA AIRPORT
DESC
===========================================================================
INCLUDE USER DALLAS BANK
INCLUDE USER DALLAS INSURANCE
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 6,3,8
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

656 CONTROL-D and CONTROL-V User Guide

 CENTERA RETENTION CLASS: Mission-specific Parameter

CENTERA RETENTION CLASS: Mission-specific

Parameter
The retention class name defined in the EMC Centera storage system. Optional. The
CENTERA RETENTION CLASS parameter is available only when migrating to the
EMC Centera storage system. The class name is an alpha-numeric case-sensitive
string containing 1 through 31 characters.

Figure 360 RETENTION CLASS Parameter Format

General information
You can specify one of the classes defined in the EMC Centera environment. The
migrated report will be retained for the period defined for that specific class.

If the CENTERA RETENTION CLASS parameter is specified, the RETENTION

DAYS parameter is ignored.

The CTVCLMIG utility reads the retention days defined for the specified class from
the EMC Centera definitions.

If this period has expired, the utility deletes the migrated report from EMC Centera
storage system.

If no value is set for the CENTERA RETENTION CLASS parameter, the report that
was migrated to EMC Centera is deleted based on the value set in the RETENTION
DAYS parameter.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 657

Example

Example
Reports migrated by this mission will be deleted from the EMC Centera storage
system by the CTVCLMIG utility when the number of days defined for the Class1
retention class in the EMC Centera definitions have expired.

Figure 361 CENTERA RETENTION CLASS Example

+-----------------------------------------------------------------------------+
| CATEGORY MIGLIM MISSION MIGLIM |
| OWNER N16A TASKTYPE MIG GROUP |
| DESC |
| =========================================================================== |
| STAGE 01 SCHEDULING PARAMETERS |
| DAYS DCAL |
| AND/OR |
| WDAYS WCAL |
| MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y |
| DATES |
| CONFCAL SHIFT RETRO N MAXWAIT 00 |
| MINIMUM PDS |
| =========================================================================== |
| IN |
| TIME FROM TO NOT LATER THAN PRIORITY |
| =========================================================================== |
| OUT |
| SHOUT WHEN TO URGN |
| MSG |
| =========================================================================== |
| RETENTION DAYS 00000 FORCE N SECONDARY SKELETON MICLIM |
| CENTERA RETENTION CLASS Class1 |
| =========================================================================== |
| STAGE 01 PRIMARY MEDIA CENTERA AGE 00001 REFRESH CTLG |
| SECONDARY MEDIA CART REFRESH CTLG |
| =========================================================================== |

658 CONTROL-D and CONTROL-V User Guide

 CONFCAL: Basic Scheduling Parameter

CONFCAL: Basic Scheduling Parameter

Name of a calendar used to confirm the scheduling of the mission. See also DAYS,
WDAYS and DATES.

Figure 362 CONFCAL Parameter Format

Optional. CONFCAL subparameters are described below:

Table 250 CONFCAL Subparameters

Subparameter Description
CONFCAL Specifies a valid calendar (member) name of 1 through 8 characters.

A calendar specified in CONFCAL is used for validating schedule

dates. Missions to be scheduled on a day, based on other specified
scheduling criteria, are checked against the CONFCAL calendar. If the
day is a working day in the CONFCAL calendar, the mission is
scheduled on that day. Otherwise, parameter SHIFT determines
whether the mission is shifted to (scheduled on) another day or is not
scheduled.
SHIFT When a mission fails confirmation for scheduling on a given day
because the day is not a working day in the CONFCAL calendar,
SHIFT determines if and when the mission is alternatively scheduled.
Valid values are:

blank No shifting occurs. The mission is not scheduled. Default.

> Mission is scheduled on (shifted to) the next working day,
according to the CONFCAL calendar.
< Mission is scheduled on (shifted to) the previous working day,
according to the CONFCAL calendar.
Note: Entering a SHIFT value does not ensure that the mission is
scheduled. SHIFT cannot add scheduling dates; it can only shift a
mission to a scheduling date that is already defined. If SHIFT does not
find a suitable date in the other scheduling criteria, the mission is not
scheduled.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 659

CONFCAL: Basic Scheduling Parameter

General Information
CONFCAL calendars are especially useful for handling holidays and other
scheduling exceptions.

If not specified, missions are scheduled according to other scheduling criteria without
confirmation.

CONFCAL should not contain the name of a periodic calendar. If it does, no day
passes the confirmation.

SHIFT cannot be specified unless CONFCAL is specified. When CONFCAL is

specified, SHIFT is optional (that is, blank defaults to no shifting).

Parameter CONFCAL cannot be used with parameters PDS and MINIMUM.

Example
This example is based on the following assumptions:

The current month is January 2000.

Working days are defined in calendar WORKDAYS, which contains the following
working days (indicated by Y) for January 2000:

--S-------------S-------------S-------------S-------------S--
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y

Start of the week is defined as Monday. Weeks start on the following dates in
January 2000: 3rd, 10th, 17th, 24th, and 31st.

Schedule the mission on the 1st, 7th and 15th day of the month if they are both
Saturdays and working days in WORKDAYS. If the day of the month (1st, 7th, 15th)
is not a Saturday, do not schedule the mission. If the day of the month is a Saturday
but is not a working day, schedule the mission on the next working day.

DAYS 1,7,15
AND/OR AND
WDAYS 6
CONFCAL WORKDAYS
SHIFT >

660 CONTROL-D and CONTROL-V User Guide

 CONFCAL: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 363 CONFCAL Parameter Example

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 661

DATES: Basic Scheduling Parameter

DATES: Basic Scheduling Parameter

Dates, by month and day, on which the mission should be scheduled for execution.

Figure 364 DATES Parameter Format

Optional. Valid values are 4-character dates in mmdd or ddmm format, depending
on the site standard.

A maximum of 12 dates can be specified.

General Information
The mission is scheduled for execution only on the dates specified in parameter
DATES.

Parameter DATES cannot be used with parameters PDS, MINIMUM, MONTHS,

DAYS and DCAL.

To specify more than 12 dates for one mission, define the dates in a calendar (instead
of using this parameter) and specify the calendar in DCAL (or WCAL).

The relationship between DATES and WDAYS/WCAL is OR. If the mission should
be scheduled according to the DATES parameter or according to the WDAY/WCAL
combination, it is scheduled.

Examples

Example 1

Schedule a mission for the 15th of January (mmdd format):

DATES=0115

662 CONTROL-D and CONTROL-V User Guide

 DATES: Basic Scheduling Parameter

Example 2

Schedule a mission for the 21st of June and the 21st of December (ddmm format):

Figure 365 DATES Parameter Example 2

---- CONTROL-D CATEGORY SPECIAL PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY SPECIAL MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP SPECIAL-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC BUNDLE FOR ALL RECIPIENTS ON SPECIAL DATES
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 1,3
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES 2106 2112
CONFCAL SHIFT RETRO N MAXWAIT 00
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 663

DAYS: Basic Scheduling Parameter

DAYS: Basic Scheduling Parameter

Days of the month on which the mission should be scheduled. See also CONFCAL
and WDAYS.

Figure 366 DAYS Parameter Format

Optional. Parameter DAYS specifies days of the month on which the mission should
be scheduled, only if other basic scheduling criteria are met. Values for DAYS can be
specified alone, or they can be specified together with a calendar specified in
subparameter DCAL. DAYS/DCAL can also be specified together with
WDAYS/WCAL (described under WDAYS in this chapter of the guide).

The DAYS subparameters are described below:

Table 251 DAYS Subparameters (part 1 of 2)

Subparameter Description
DAYS Days of the month on which to schedule a mission. (The months in
which to schedule missions are specified in parameter MONTHS,
described later in this chapter.) Various formats (described later) can
be used to specify DAYS (for example, 3 means the 3rd day of the
month, L2 means the day before the last day of the month, D1PA
means the 1st day in period A).
DCAL Name of a calendar containing a predefined set of dates (referred to as
working days) on which a mission should be scheduled. A specified
value must be a valid member name of 1 through 8 characters, or an *
to indicate that the calendar specified in parameter CONFCAL should
be used for scheduling. For further information on how to define, use
and modify calendars, see IOA Calendar Facility in Chapter 2.
Note: A calendar specified in DCAL does not have to exist when
defining parameter DAYS. However, it must exist when the mission is
being scheduled.

664 CONTROL-D and CONTROL-V User Guide

 DAYS: Basic Scheduling Parameter

Table 251 DAYS Subparameters (part 2 of 2)

Subparameter Description
AND/OR Conjunctional parameter used to link parameters DAYS and WDAYS
when both are specified.

A (AND)Both DAYS (/DCAL) and WDAYS (/WCAL) criteria

must be met to schedule a mission.
O (OR)DAYS (/DCAL) and or WDAYS (/WCAL) criteria must
be met to schedule a mission. Default.

If A (AND) is specified when either DAYS or WDAYS is specified (but

not both), the missing DAYS or WDAYS value is automatically set to
ALL.

Assuming all other basic scheduling criteria are met:

When DAYS are specified without DCAL, the mission is scheduled on the
specified days (in the specified months).

When DCAL is specified without DAYS, the mission is scheduled on all working
days marked in the DCAL calendar.

When DAYS and DCAL are both specified, scheduling depends on the
combination of working days defined in the calendar and the values and format of
parameter DAYS (described below).

When both DAYS and WDAYS criteria are specified, scheduling depends on the
AND/OR parameter connecting them.

Valid Formats for Parameter DAYS

Valid formats for parameter DAYS, and how they relate to DCAL, are described
below.

In the following non-periodic scheduling formats:

n is an integer from 1 to 31.

Multiple values can be specified (separated by commas) in any order.
DCAL must not contain the name of a periodic calendar.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 665

DAYS: Basic Scheduling Parameter

Table 252 Non-Periodic Scheduling Formats

Format Description
ALL All days of the month. If ALL is specified, other DAYS values cannot be
specified with it.

If a DCAL calendar is not defined, schedule the mission on all days in the
month. If a DCAL calendar is defined, schedule the mission only on the working
days indicated in the calendar.
n,... Specific days of the month.

If a DCAL calendar is not defined, schedule the mission on the specified days. If
a DCAL calendar is defined, schedule the mission only when a day is defined as
a working day in both the DAYS parameter and the DCAL calendar.
+n,... Days of the month in addition to the working days specified in the DCAL
calendar. DCAL is mandatory.
n,... Schedule the mission on all days except the nth day from the beginning of the
month. DCAL is mandatory.
>n,... Schedule the mission on the indicated day if it is a working day in the DCAL
calendar; otherwise, schedule the mission on the next working day that is not
negated by a n value in this parameter. This format is frequently used for
holiday handling. DCAL is mandatory.
<n,... Schedule the mission on the indicated day if it is a working day in the DCAL
calendar; otherwise, schedule the mission on the last previous working day that
is not negated by n value in this parameter. This format is frequently used for
holiday handling. DCAL is mandatory.
Dn,... Schedule the mission on the nth working day from the beginning of the month.
DCAL is mandatory.
Dn,... Schedule the mission on all working days except the nth working day from the
beginning of the month. DCAL is mandatory.
Ln,... Schedule the mission on the nth day (or nth working day if DCAL is defined)
counting backward from the end of the month. DCAL is optional.
Ln,... If DCAL is defined, schedule the mission on all working days except the nth
working day counting backward from the end of the month. If DCAL is not
defined, schedule the mission on all days except the nth day counting backward
from the end of the month. DCAL is optional.

In the following periodic scheduling formats:

n is an integer from 1 to 63 and i is any valid period identifier. An * can be specified

as the i value to represent all periods. An * can be specified as the n value in format
DnPi, to represent all days. (* is not a valid n value in formats DnPi, LnPi and
LnPi.)

If the number of days between periods with the same identifier is more than 33
(this value can be changed by the INCONTROL administrator), it is considered a
new period.

666 CONTROL-D and CONTROL-V User Guide

 DAYS: Basic Scheduling Parameter

The name of a periodic calendar must be specified in DCAL. For details about
periodic calendars, see IOA Calendar Facility on page 390.

Table 253 Periodic Scheduling Formats

Format Effect
DnPi,... Schedule the mission on the nth day of period of i from the beginning of the
period.
DnPi,... Schedule the mission on all days of period i except the nth day of period i
from the beginning of the period.
LnPi,... Schedule the mission on the nth day of period i counting backward from the
last day of the period.
LnPi,... Schedule the mission on all days of period i except the nth day of period i
counting backward from the last day of the period.

General Information
Negative values take precedence over positive values when determining whether or
not a mission is scheduled on a certain date. If a negative value (for example, format
n, Dn, Ln, DnPi, or LnPi) in either the DAYS or WDAYS field prevents a mission
from being scheduled on a date, the mission is not scheduled on that date even if a
positive value (such as Ln) would otherwise result in the mission being scheduled on
that date.

A maximum of eight periodic values (of type DnPi, DnPi, LnPi, and LnPi) can be
designated in any desired order.

If periodic and non-periodic values are mixed when specifying parameter DAYS,
processing depends on the calendar type specified in parameter DCAL:

If a non-periodic calendar is specified in the DCAL parameter, only non-periodic

values in the DAYS parameter are processed; periodic values are ignored. In this
case, negative periodic values (such as DnPi, LnPi) are also ignored and do not
supersede other values.

If a periodic calendar is specified in the DCAL parameter, all periodic values and
the negative non-periodic value -n in the DAYS parameter are processed; all other
non-periodic values are ignored.

D*Pi and D*P*, and L*Pi and L*P* are not permitted, because these values would
result in scheduling the mission on no days in a period or no days in all periods, a
meaningless request.

Parameter MONTHS is ignored when periodic values are specified in parameter

DAYS.

Parameter DAYS cannot be used with parameters PDS, MINIMUM, and DATES.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 667

DAYS: Basic Scheduling Parameter

Examples
The examples in this chapter are based on the following assumptions:

The current month is January 2000.

Working days are defined in calendar WORKDAYS. Working days for January
2000 are indicated by a Y.

---S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y

WDAYS are defined as working days beginning on Monday.

Periodic calendar PERIDAYS contains the following periodic definition for

January 2000. These examples assume that all other days of this calendar are blank.

---S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
B C A A B B C A A B B C A A B B C A A B B

Start of the week is defined as Monday. Weeks start on the following dates in
January 2000: 3rd, 10th, 17th, 24th, and 31st.

At the end of each example, asterisks in a January 2000 calendar indicate the days on
which the mission is scheduled.

Example 1

Schedule the mission on the 17th day and the last day of the month.

DAYS 17,L1

668 CONTROL-D and CONTROL-V User Guide

 DAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 367 DAYS Parameter Example 1

Example 2

Schedule the mission on all working days of the month except the 6th day of the
month, and also schedule the mission on the 1st day of the month.

DAYS +1,-6
DCAL WORKDAYS

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 368 DAYS Parameter Example 2

Example 3

Schedule the mission on all working days of the month except the first and last
working days of the month, and except the 17th day of the month.

DAYS -D1,-17,-L1
DCAL WORKDAYS

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 669

DAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 369 DAYS Parameter Example 3

Example 4

Schedule the mission on the 8th day of the month. If it is a non-working day, schedule
the mission on the closest preceding working day.

DAYS <8
DCAL WORKDAYS

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 370 DAYS Parameter Example 4

Example 5

Schedule the mission on the 1st day of period A, and on all days, except the 2nd day,
of period B. Do not schedule the mission on the 5th day of the month.

DAYS -5,D1PA,-D2PB
DCAL PERIDAYS

670 CONTROL-D and CONTROL-V User Guide

 DAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 371 DAYS Parameter Example 5

Example 6

Schedule the mission on each Monday and on the 1st day of the month.

DAYS 1
AND/OR OR
WDAYS 1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 372 DAYS Parameter Example 6

Example 7

Schedule the mission on the 3rd day of the month only if it is a Monday.

DAYS 3
AND/OR AND
WDAYS 1

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 671

DAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 373 DAYS Parameter Example 7

Example 8

Schedule the mission on the last Monday of the month.

DAYS L1,L2,L3,L4,L5,L6,L7
AND/OR AND
WDAYS 1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 374 DAYS Parameter Example 8

Example 9

Schedule the mission on the 1st, 7th and 15th days of the month if they are both
Saturdays and working days. If the day of the month (1st, 7th, 15th) is not a Saturday,
do not schedule the mission. If the day of the month is a Saturday, but it is not a
working day, schedule the mission on the next working day.

DAYS 1,7,15
AND/OR AND
WDAYS 6
CONFCAL WORKDAYS
SHIFT >

672 CONTROL-D and CONTROL-V User Guide

 DAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 375 DAYS Parameter Example 9

Example 10

Schedule the mission to run on the first Friday after the 15th of the month.

DAYS 16,17,18,19,20,21,22
AND/OR AND
WDAYS 5

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 376 DAYS Parameter Example 1

0

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 673

DESC: General Parameter

DESC: General Parameter

Mission description that is displayed in the Category List screen.

Figure 377 DESC Parameter Format

Optional. Parameter DESC specifies a text of 1 through 50 characters per line. When
you enter text in parameter DESC and press Enter, another DESC line is displayed. An
unlimited number of description lines can be specified.

General Information
Parameter DESC is informational. It does not affect mission processing. The
description is intended to let the user know the purpose of (or some other key
information about) the mission.

A mission description can be written in any language. It is used as an internal help

facility, assisting the user in controlling the mission.

Example
Category NORTH-COURIER is displayed in the Category List screen with the
description BUNDLE FOR COURIER TO NORTH BRANCHES.

674 CONTROL-D and CONTROL-V User Guide

 DESC: General Parameter

Figure 378 DESC Parameter Example

---- CONTROL-D CATEGORY NORTH-COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY NORTH-COURIER MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP DAILY-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC BUNDLE FOR COURIER TO NORTH BRANCHES
DESC
===========================================================================
INCLUDE USER NORTH
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 6,3,8
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 675

GROUP: General Parameter

GROUP: General Parameter

The missions group name. This parameter provides a common descriptive name for
a group of missions.

Figure 379 GROUP Parameter Format

Optional. One to 20 characters. Only trailing blanks are allowed.

General Information
Parameter GROUP makes handling missions more convenient. It enables retrieval of
information about a specific groups missions, usually via the Online facility or the
Reporting facility.

The group name appears in all important messages relating to the groups missions.

Overriding DDNAME

Parameter GROUP can be used to override the DD name for a SYSOUT issued by
CONTROL-V to SPOOL, by specifying a value beginning with DD= in one of the
following ways:

DD=%U (USER name)

DD=%P (PRINT mission_name)
DD=%J (JOB name)

where

name is the name of the USER or JOB.

mission_name is the name of the print mission.

676 CONTROL-D and CONTROL-V User Guide

 GROUP: General Parameter

Overriding Installation Parameter OUTGRP (supported in MVS-JES2

environments only)

Parameter GROUP can be used to override CONTROL-V installation parameter

OUTGRP (except OUTGRP=N) by specifying a value beginning with ID=, as follows:

Table 254 Use of GROUP Parameter to Override OUTGRP Parameter

Value Description
ID=%R Provides the same output as OUTGRP=R
ID=%U Provides the same output as OUTGRP=U
ID=%P Provides the same output as OUTGRP=P
ID=%J Provides the same output as OUTGRP=J
ID=%TIMESTP OUTGRP is set to the timestamp (a unique value for each printing
mission).
ID=string OUTGRP is set to the specified string.

When installation parameter OUTGRP is set to Y, chunking is implemented as

follows:

By report if the value of parameter GROUP is ID=%R

By user if the value of parameter GROUP is ID=%U
By mission name if the value of parameter GROUP is ID=%P
By jobname if the value of parameter GROUP is ID=%J

For details, see parameter OUTGRP in the CONTROL-D chapter of the INCONTROL
for z/OS Installation Guide.

For information about chunking, see the CONTROL-D and CONTROL-V chapter
of the INCONTROL for z/OS Administrator Guide.

Example
This printing mission belongs to the DAILY-PRT-BLUE-FORM group.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 677

GROUP: General Parameter

Figure 380 GROUP Parameter Example

---- CONTROL-D CATEGORY DAILY PRT MISSION BLUEFORM --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION BLUEFORM MONITOR
OWNER M22 TASKTYPE PRT GROUP DAILY-PRT-BLUE-FORM
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC DAILY BUNDLE FOR ALL RECIPIENTS ON BLUE FORM
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 6,3,8
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

678 CONTROL-D and CONTROL-V User Guide

 IN: Runtime Scheduling Parameter

IN: Runtime Scheduling Parameter

Prerequisite conditions for mission execution.

Figure 381 IN Parameter Format

Optional. A maximum of two prerequisite conditions can be specified in each IN line.

When you specify the second prerequisite condition in a line and press Enter, a new
line is opened for specifying additional prerequisite conditions.

Each specified prerequisite condition consists of the following subparameters:

Table 255 IN Prerequisite Condition Subparameters

Subparameter Description
cond_name User-supplied, descriptive name of 1 through 20 characters used to
identify the condition. Mandatory.
dateref 4-character date reference. Mandatory. Valid values are:

date Specific date (in either mmdd or ddmm format, depending

on the site standard).

STAT Static. Indicates that the condition (such as PRINTER-SET)

is not date-dependent

ODAT Original schedule date. Default.

PREV Previous date on which the mission should have been

scheduled, according to its basic scheduling criteria (or ODATE
1 for a forced mission.)

**** Any schedule date.

$$$$ Any schedule date.

If a date reference is not specified, value ODAT is automatically

inserted.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 679

IN: Runtime Scheduling Parameter

General Information
The mission executes only if all the prerequisite conditions (specified in parameter
IN) are satisfied.

A prerequisite condition can represent any user-specified situation. The following are
a few examples of prerequisite conditions:

Morning-A-PRINTED
RESTORE-NEEDED
JOB-EJGH12-FINISHED
SALARY-DECOLLATED

Mission execution dependencies can be defined and implemented using prerequisite

conditions. Usage of prerequisite conditions encompasses mission-to-mission or
job-to-mission dependencies, or mission dependencies based on successful
completion of a manual task (such as data entry or quality control).

A prerequisite condition can be created or deleted in various ways. For more

information see the following:

OUT: Post-processing Parameter on page 702

Adding Conditions and Resources The ADD Command on page 370
Prerequisite Condition Concept on page 70

Each prerequisite condition is associated with a specific scheduling date. This

scheduling date differentiates between different runs of the same mission for
different scheduling dates.

The PREV date reference automatically resolves into a scheduling date reference for
the missions previous scheduling date (or ODATE1 for a forced mission).

The **** or $$$$ date reference indicates that any date is acceptable. Only the
prerequisite condition name must match.

Examples

Example 1

Activate the printing mission only after the salary reports report decollating mission
finishes OK. When the salary reports report decollating mission finishes OK, it
creates the prerequisite condition SALARY-DECOLLATED.

680 CONTROL-D and CONTROL-V User Guide

 IN: Runtime Scheduling Parameter

Figure 382 IN Parameter Example 1

---- CONTROL-D CATEGORY NORTH-COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
IN SALARY-DECOLLATED ODAT
TIME FROM TO NOT LATER THAN PRIORITY
ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG PRINTING MISSION STD ENDED NOTOK
SHOUT WHEN TO URGN
MSG
PRINTER PRT1 DEST CHUNKSIZE
PRINTER PRT2 DEST CHUNKSIZE
PRINTER DEST CHUNKSIZE
ON FORM
REQUEST
======= >>>>>>> END OF PRINTING MISSION PARAMETERS OF THIS CATEGORY <<<<<< ====

PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 10.19.22

Example 2

Suppose a printing mission should be executed only after the totals of a report have
been checked for reasonableness. Parameter IN can specify a prerequisite condition
such as REPORT404-CHECKED, which is created manually after the report has been
checked. For more information, see Adding Conditions and Resources The ADD
Command on page 370.

Figure 383 IN Parameter Example 2

---- CONTROL-D CATEGORY NORTH-COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
IN REPORT404-CHECKED ODAT
TIME FROM TO NOT LATER THAN PRIORITY
ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG PRINTING MISSION STD ENDED NOTOK
SHOUT WHEN TO URGN
MSG
PRINTER PRT1 DEST CHUNKSIZE
PRINTER PRT2 DEST CHUNKSIZE
PRINTER DEST CHUNKSIZE
ON FORM
REQUEST
======= >>>>>>> END OF PRINTING MISSION PARAMETERS OF THIS CATEGORY <<<<<< ====

PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.41

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 681

INCLUDE/EXCLUDE USER: Printing Mission Bundling Parameter

INCLUDE/EXCLUDE USER: Printing Mission

Bundling Parameter
Users whose reports are included in (or excluded from) the bundle.

Figure 384 INCLUDE/EXCLUDE USER Parameters Format

Optional (but highly recommended).

NOTE
Parameters INCLUDE/EXCLUDE USER apply to printing missions only.

Parameters INCLUDE/EXCLUDE USER specify user names of 1 through 8

characters. Each name must be a valid user name from the Recipient Tree. Synonyms
from the Recipient Tree cannot be used. Prefixing is supported. An unlimited number
of INCLUDE USER and EXCLUDE USER entries can be specified.

General Information
Reports belonging to the user specified in parameter INCLUDE USER are included in
the bundle. In addition, reports belonging to the users children (users appearing
under the user in the Recipient Tree) are also included, unless specifically excluded
by an EXCLUDE USER parameter.

When parameter EXCLUDE USER is specified, reports belonging to the specified user
are excluded from the bundle. In addition, reports belonging to the users children (in
the Recipient Tree) are excluded from the bundle, unless specifically included by an
INCLUDE USER parameter.

If no INCLUDE USER parameter is specified, the entire Recipient Tree is included

(minus any users excluded by an EXCLUDE USER parameter).

682 CONTROL-D and CONTROL-V User Guide

 INCLUDE/EXCLUDE USER: Printing Mission Bundling Parameter

Example
Include in the bundle reports belonging to the Accounting Department (user
ACCOUNT) and belonging to all users under the Accounting Department in the
Recipient Tree. However, exclude reports belonging to the Accounts Payable section
(user ACCPAYBL). This also excludes reports belonging to ACCPAYBLs children in
the Recipient Tree.

Figure 385 INCLUDE/EXCLUDE USER Parameter Example

---- CONTROL-D CATEGORY ACCOUNTING-DEP PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY ACCOUNTING-DEP MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP DAILY-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC BUNDLE FOR THE ACCOUNTING DEPARTMENT
DESC
===========================================================================
INCLUDE USER ACCOUNT
INCLUDE USER
EXCLUDE USER ACCPAYBL
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 6,3,8
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 683

INTERVAL: Runtime Scheduling Parameter

INTERVAL: Runtime Scheduling Parameter

Specifies the minimum number of minutes to wait between successive executions of a
cyclic printing or restore mission. See also TASKTYPE (Cyclic).

Figure 386 INTERVAL Parameter Format

Optional. Parameter INTERVAL specifies a number of minutes, from 000 through

255. Leading zeros are automatically inserted. The default (blank) represents 000,
which means there is no minimum time interval between cyclic missions.

The specified interval starts from the time the previous mission finished executing.

NOTE
This parameter applies to restore and printing missions only.

General Information
A cyclic mission is generally executed at a regular interval defined by parameter
INTERVAL. Cyclic missions (see parameter TASKTYPE) are used to execute printing
and restore requests which have accumulated since the previous execution.

Parameter INTERVAL specifies the minimum time required between executions.

Other parameters (such as TIME or IN prerequisite conditions) can suppress or delay
the missions execution.

Parameter ON PAGE# can trigger execution of a cyclic printing mission even if the
INTERVAL requirement or another condition has not been satisfied.

684 CONTROL-D and CONTROL-V User Guide

 INTERVAL: Runtime Scheduling Parameter

Example
Execute this restore mission every three hours.

Figure 387 INTERVAL Parameter Example

---- CONTROL-D CATEGORY DAILY RST MISSION RST0180M --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION RST0180M
OWNER M22 TASKTYPE CRS GROUP DAILY-RST
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC RESTORE MISSION - EVERY THREE HOURS
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
TIME FROM 0000 TO NOT LATER THAN PRIORITY INTERVAL 180
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG RESTORE MISSION RSTADHOC ENDED NOTOK
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.47.59

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 685

MAXWAIT: Basic Scheduling Parameter

MAXWAIT: Basic Scheduling Parameter

Number of extra days the mission can wait in the Active Missions file for execution.

Figure 388 MAXWAIT Parameter Format

Optional. Valid values: 0098 (days) or 99 (no limit). A leading zero is required.

Table 256 MAXWAIT Parameter Values

Value Description
MAXWAIT=00 The mission is not executed if it did not execute on the original
scheduling date. Default.
MAXWAIT=nn Where nn=0198. If the mission did not execute on its original
scheduling date, it is given an additional number of days to execute. It
can remain in the Active Missions file up to nn days awaiting execution.
MAXWAIT=99 The mission remains in the Active Missions file (until deleted manually)
even if it finished executing.

General Information
Parameter MAXWAIT is used to overcome the problem of delays in production. A
mission that is scheduled for execution on a specific day does not always finish
executing that same day. A mission may be delayed due to number of reasons, such
as hardware failure, a heavy production workload, or a bug in one of the missions
predecessors. Therefore, it may be desirable to specify an additional number of days
that the mission should remain available for execution.

When a mission is disregarded (that is, CONTROL-V times out), an appropriate

message is written to the IOA Log file.

When a mission is scheduled because parameter RETRO is set to Y, the mission

always has at least one day to execute. This occurs even if the current working date
exceeds the MAXWAIT days after the missions last original scheduling date. For
additional information, see parameter RETRO later in this chapter.

686 CONTROL-D and CONTROL-V User Guide

 MAXWAIT: Basic Scheduling Parameter

Emergency missions are also disregarded if their MAXWAIT periods have passed.

An emergency mission that belongs to a specific group (through parameter GROUP)

and whose MAXWAIT period has not passed, is not deleted from the Active Missions
file until all regular missions belonging to the same group have finished executing.
This is desirable because the mission may be needed again at a later stage (due to a
job rerun).

Examples

Example 1

The mission should stay in the Active Missions file indefinitely:

MAXWAIT=99

Example 2

The mission should be given an extra three days to execute after its original
scheduling date has passed:

DAYS=2,4,6
MAXWAIT=3
RETRO=Y

Assume that the mission does not run due to the absence of the required runtime
conditions. The mission that is scheduled for the 2nd of the month waits from the 2nd
through the 5th to be executed.

On the 6th, CONTROL-V times out and the mission scheduled for the 2nd is not
executed. The missions scheduled for the 4th and 6th waits for execution until the 7th
and 9th, respectively.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 687

MAXWAIT: Basic Scheduling Parameter

Figure 389 MAXWAIT Parameter Example 2

---- CONTROL-D CATEGORY BEGIN-MONTH PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY BEGIN-MONTH MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP B_MONTH-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC BUNDLE FOR ALL RECIPIENTS AT THE BEGINNING OF THE MONTH
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 1,3
===========================================================================
DAYS 02,04,06 DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 03
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

688 CONTROL-D and CONTROL-V User Guide

 MINIMUM: Basic Scheduling Parameter

MINIMUM: Basic Scheduling Parameter

Minimum number of free tracks required by the library specified in parameter PDS.
See also PDS.

Figure 390 MINIMUM Parameter Format

Optional; however, if PDS is specified, MINIMUM is mandatory. Parameter

MINIMUM specifies the minimum number of free tracks required. This must be a
positive 3-digit number (leading zeros are inserted automatically).

Parameter MINIMUM cannot be used with parameters DAYS, WDAYS, MONTHS,

CONFCAL, RETRO and DATES.

NOTE
This parameter is supported for compatibility with previous versions.

General Information
Parameters MINIMUM and PDS are always used together and are never used with
other Basic Scheduling parameters.

Parameter PDS identifies a library, and parameter MINIMUM specifies the minimum
number of free tracks required by that library.

These parameters are intended for use (definition) in missions which issue a warning
message if the minimum number of free tracks is not available.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 689

MINIMUM: Basic Scheduling Parameter

If parameters MINIMUM and PDS are defined for a mission, the scheduling of the
mission is not related to or dependent upon any date criteria. Instead, the mission is
scheduled if the actual number of free tracks available in the specified library is below
the specified minimum at time of daily mission ordering. The mission can then issue
the appropriate warning.

NOTE
MINIMUM does not work with PDSE-type libraries because they always appear to be 100%
full. MINIMUM only checks current extents.

Example
Schedule the mission when there are less than 20 unused tracks in library
ALL.PARMLIB.

Figure 391 MINIMUM Parameter Example

---- CONTROL-D CATEGORY PDS PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY PDS MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP PDS-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC PARMLIB HAS LESS THAN 20 TRACKS
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ :
===========================================================================
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 03
MINIMUM 020 PDS ALL.PARMLIB
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

690 CONTROL-D and CONTROL-V User Guide

 MISSION: General Parameter

MISSION: General Parameter

Name of the mission.

Figure 392 MISSION Parameter Format

Mandatory. Parameter MISSION must be a valid mission name of 1 through 8

characters.

General Information
Printing missions: The MISSION name must also be specified in the Report
Decollating Mission screen (statement DO PRINT) for all reports printed by this
mission. When the printing mission executes, it prints all reports assigned to it
through parameter DO PRINT if they have been decollated and have not yet been
printed.

Migration and backup missions: The MISSION name must also be specified in either
statement DO MIGRATE or DO BACKUP of the Report Decollating Mission screen
for all reports migrated or backed up by this mission. When the mission executes, it
migrates or backs up all reports assigned to it through statement DO MIGRATE or
DO BACKUP if they have been decollated and have not yet migrated or been backed
up.

Restore missions: This parameter is used for descriptive purposes (for example,
IMMEDIATE, HOURLY).

Example
The STD printing mission prints all the reports that should be printed that day.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 691

MISSION: General Parameter

Figure 393 MISSION Parameter Example

---- CONTROL-D CATEGORY DAILY PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP DAILY-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC DAILY BUNDLE FOR ALL RECIPIENTS
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 6,3,8
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

692 CONTROL-D and CONTROL-V User Guide

 MONITOR: General Parameter

MONITOR: General Parameter

Print monitor for this printing mission.

Figure 394 MONITOR Parameter Format

NOTE
This parameter applies to printing missions only.

Optional. Parameter MONITOR can be blank or a number from 1 through 9.

Numbers 1 through 9 designate the ID of a print monitor defined at time of
installation.

General Information
If parameter MONITOR is not specified, a print monitor is assigned on a rotation
method by the CONTROL-V monitor.

The print monitor number (ID) cannot be greater than the value of installation
parameter PRTMON# . If PRTMON# is set to 0, no print monitors are started but
printing missions can be executed as batch jobs. For information on this topic, see
parameter BATCH in this chapter.

Example
The print monitor whose ID was set to 2 at the time of installation handles the
printing of the reports in this printing mission.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 693

MONITOR: General Parameter

Figure 395 MSSION Parameter Example

---- CONTROL-D CATEGORY DAILY PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION STD MONITOR 2
OWNER M22 TASKTYPE PRT GROUP DAILY-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC DAILY BUNDLE FOR ALL RECIPIENTS
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 6,3,8
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

694 CONTROL-D and CONTROL-V User Guide

 MONTHS: Basic Scheduling Parameter

MONTHS: Basic Scheduling Parameter

Months of the year during which the mission should be scheduled for execution.

Figure 396 MONTHS Parameter Format

Optional. The months in the year are represented by the numbers 1 through 12. A
value can be specified for each month. Valid values are:

Table 257 MONTHS Parameter Values

Value Description
Y (Yes) Schedule the mission in that month. Default.
N (No) Do not schedule the mission in that month.
(or blank)

General Information
The mission is scheduled for execution only during the months in which a value of Y
is specified.

Parameter MONTHS cannot be used with parameters PDS, MINIMUM and DATES.

When parameter MONTHS is used, at least one of the following must be specified:
DAYS, DCAL, WDAYS or WCAL. When specified with one of these parameters,
parameter MONTHS works as a filter to limit the mission schedule.

Parameter MONTHS is ignored when periodic values are specified in parameter

DAYS or WDAYS.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 695

MONTHS: Basic Scheduling Parameter

Examples

Example 1

Schedule a mission in all months of the year:

MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y

Example 2

Schedule a mission every day in March and September.

Figure 397 MONTHS Parameter Example 2

---- CONTROL-D CATEGORY MARCH-SEPTEMBER BKP MISSION BKP0031D --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY MARCH-SEPTEMBER MISSION BKP0031D
OWNER M22 TASKTYPE BKP GROUP MAR_SEP-BKP
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC BACKUP REPORTS FOR 200 DAYS, SCHEDULED IN MARCH AND SEPTEMBER
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- N 2- N 3- Y 4- N 5- N 6- N 7- N 8- N 9- Y 10- N 11- N 12- N
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN OP-START-BACKUP-031D ODAT
TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
# OF DAYS TO KEEP 00200 # OF GENERATIONS TO KEEP
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 12.53.58

696 CONTROL-D and CONTROL-V User Guide

 NOT LATER THAN: Runtime Scheduling Parameter

NOT LATER THAN: Runtime Scheduling

Parameter
Time by which the mission starts executing even if the prerequisite conditions
specified in parameter IN do not exist.

Figure 398 NOT LATER THAN Parameter Format

Optional. Parameter NOT LATER THAN must be in hhmm format (where hh is the
hour and mm is the minute).

Examples:

2101 = 09:01 p.m.

0301 = 03:01 a.m.

General Information
This parameter triggers execution of the mission at the specified time even if the
prerequisite conditions specified in parameter IN do not exist. Use this parameter in
those cases where the prerequisite condition is desirable but not absolutely necessary
for execution of the mission.

When parameter NOT LATER THAN is not specified, the mission executes only if the
prerequisite conditions and the other scheduling requirements are satisfied.

Example
Execute the print mission at 3:00 a.m. even if the prerequisite conditions do not exist.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 697

NOT LATER THAN: Runtime Scheduling Parameter

Figure 399 NOT LATER THAN Parameter Example

---- CONTROL-D CATEGORY NORTH-COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
IN REPORT404-CHECKED ODAT SALARY-DECOLLATED ODAT
IN
TIME FROM TO NOT LATER THAN 0300 PRIORITY
ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG PRINTING MISSION STD ENDED NOTOK
SHOUT WHEN TO URGN
MSG
PRINTER PRT1 DEST CHUNKSIZE
PRINTER PRT2 DEST CHUNKSIZE
PRINTER DEST CHUNKSIZE
ON FORM
REQUEST
======= >>>>>>> END OF PRINTING MISSION PARAMETERS OF THIS CATEGORY <<<<<< ====

PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 10.19.22

698 CONTROL-D and CONTROL-V User Guide

 ON LINE#: Runtime Scheduling Parameter

ON LINE#: Runtime Scheduling Parameter

Parameter ON LINE# (printing missions only) is reserved for future use.

Figure 400 ON LINE# Parameter Format

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 699

ON PAGE#: Runtime Scheduling Parameter

ON PAGE#: Runtime Scheduling Parameter

Threshold number of pages that can initiate execution of a printing mission.

Figure 401 ON PAGE# Parameter Format

NOTE
This parameter applies to printing missions only.

Optional. This parameter specifies a 6-digit number (of pages) from 1 through 999999.

General Information
ON PAGE# specifies the number of pages to be counted before execution of a
printing mission begins (even if other runtime scheduling criteria are not met). If the
number of pages to be printed by the printing mission reaches or exceeds this
threshold, execution of the mission begins.

Only report pages decollated by means of a DO PRINT statement are counted. Report
pages for which a (re)print request was issued using option P (Print) in a User Report
List screen are not counted.

During the scheduling process, the ON PAGE# counter is checked before processing
IN conditions but after processing the TIME parameter. Therefore, a printing mission
cannot be triggered by parameter ON PAGE# if its TIME criteria are not satisfied, but
can be triggered even if a required prerequisite condition does not exist.

If parameter ON PAGE# is specified in a cyclic printing mission, the normal time

interval between cycles may be reduced. If parameter ON PAGE# causes a cyclic
printing mission to be executed, a new time interval begins. For more information,
see parameter INTERVAL earlier in this chapter.

700 CONTROL-D and CONTROL-V User Guide

 ON PAGE#: Runtime Scheduling Parameter

Example
This cyclic printing mission executes every 30 minutes. However, if 100 pages have
been decollated since the last execution, the mission is executed ahead of schedule
and a new time interval is started.

Figure 402 ON PAGE# Parameter Format

---- CONTROL-D CATEGORY AIRPORT-COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY OVERFLOW MISSION CYCPRT MONITOR
OWNER N16A TASKTYPE CPR GROUP
BATCH N SKELETON FREE CLOSE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ :
===========================================================================
DAYS ALL DCAL
AND/OR O
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
TIME FROM TO NOT LATER THAN PRIORITY
ON PAGE# 000100 ON LINE# INTERVAL 030
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 11.40.07

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 701

OUT: Post-processing Parameter

OUT: Post-processing Parameter

Prerequisite conditions to be added and/or deleted when the mission ends OK.

Figure 403 OUT Parameter Format

Optional. A maximum of two prerequisite conditions can be specified in each OUT

line. Upon specifying the second prerequisite condition in a line and pressing Enter, a
new line is opened for specifying additional prerequisite conditions.

Each specified prerequisite condition consists of the following mandatory

subparameters:

702 CONTROL-D and CONTROL-V User Guide

 OUT: Post-processing Parameter

Table 258 OUT Subparameters

Subparameter Description
cond_name User-supplied, descriptive name of 1 through 20 characters that
identifies the condition.
dateref 4-character date reference. Mandatory. Valid values are:

dateSpecific date (in either mmdd or ddmm format, depending

on the site standard).

STATStatic. Indicates that the condition (such as PRINTER-SET)

is not date-dependent

ODATOriginal schedule date. Default.

PREVPrevious date on which the mission should have been

scheduled, according to its basic scheduling criteria (or ODATE1
for a forced mission.)

NEXTNext scheduling date (or, ODAT+1 for a forced mission.)

****Any schedule date.

$$$$Any schedule date.

If a date reference is not specified, the value ODAT is automatically

inserted when you press Enter.
opt Indicates whether to add or delete the specified prerequisite
condition. Valid values are:

+ Add (create) the prerequisite condition.

- Delete the prerequisite condition.

General Information
If the mission ends OK, the prerequisite conditions are added to or deleted from the
IOA Conditions file according to the specified opt value.

Prerequisite conditions are usually used to establish job or mission dependencies or

to ensure manual intervention when required.

To establish job or mission dependency, define a prerequisite condition in an OUT

or DO COND statement in the job or mission that should run first, and in an IN
statement in the job or mission that should run afterwards.

The job or mission containing a prerequisite condition in an IN statement is not

submitted unless that prerequisite condition has been added manually or by a job
or mission containing the OUT or DO COND statement.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 703

OUT: Post-processing Parameter

An OUT statement can be used to add or delete a prerequisite condition if the job
or mission ends OK.

A DO COND statement can be used in a Report Decollating mission to add or

delete a prerequisite condition if the identifying string specified in the
accompanying WHEN statement is found. A DO COND statement can also be
used by CONTROL-M (if installed) to add or delete a prerequisite condition if the
step or codes event criteria specified in the accompanying ON statement are
satisfied. The DO COND parameter is described in DO COND: Decollating
Parameter on page 454 and in the CONTROL-M for z/OS User Guide.

If the IN condition can only be satisfied by manual intervention (for example,

TAPE1-LOADED is set by the operator after loading a tape), performance of the
required manual intervention before mission submission is ensured.

If an IN prerequisite condition for a job or mission is not an IN prerequisite condition

for any other job or mission, you can use the OUT statement to delete the prerequisite
condition after the job or mission ends OK.

The following are examples of prerequisite conditions:

OSS-READY
PRINTER-SET
SALARY_DECOLLATED

All prerequisite conditions are associated with a date reference that is used to
distinguish between different runs of the same job or mission with different
scheduling dates. If, for example, a condition is being deleted, only the condition
matching the specified date is deleted. The same condition from a different date is not
deleted. When adding or deleting prerequisite conditions, the date associated with
the prerequisite condition can be a specific 4-character date or one of the following
symbolic dates:

Table 259 OUT Parameter Prerequisite Condition Symbolic Dates

Symbolic Date Effect
STAT Adds or deletes a prerequisite condition with the date value STAT.
ODAT Adds or deletes the prerequisite condition with the original
scheduling date of the job or mission.
PREV Adds or deletes the prerequisite condition with the previous
scheduling date of the job or mission (or ODAT1 if the job or mission
is being forced).
NEXT Adds or deletes the prerequisite condition with the next scheduling
date of the mission (orODAT+1 for a forced mission).
**** or $$$$ Valid only with an opt value of . Either of these values results in the
deletion of all matching prerequisite conditions regardless of date.

704 CONTROL-D and CONTROL-V User Guide

 OUT: Post-processing Parameter

Prerequisite conditions created by parameter OUT can trigger the execution of other
jobs or missions.

Prerequisite conditions deleted by parameter OUT can prevent the scheduling of jobs
and missions that require those prerequisite conditions in their IN parameter.

For more information regarding prerequisite conditions, see Prerequisite Condition

Concept on page 70.

Example
After the printing mission for the airport courier has ended OK, permit the printing of
other missions.

The prerequisite condition AIRPORT-PRINTED, specified in parameter OUT,

triggers the execution of other printing missions.

Figure 404 OUT Parameter Example

---- CONTROL-D CATEGORY AIRPORT-COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
IN
TIME FROM TO NOT LATER THAN PRIORITY 90
ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT AIRPORT-PRINTED ODAT +
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG PRINTING MISSION STD - CATEGORY "AIRPORT" ENDED NOTOK
SHOUT WHEN TO URGN
MSG
PRINTER PRT1 DEST CHUNKSIZE
PRINTER PRT2 DEST CHUNKSIZE
PRINTER DEST CHUNKSIZE
ON FORM
REQUEST
======= >>>>>>> END OF PRINTING MISSION PARAMETERS OF THIS CATEGORY <<<<<< ====

PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 10.19.22

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 705

OVERRIDE: General Parameter

OVERRIDE: General Parameter

Values which supersede the corresponding CLASS, DEST, EXTWTR and FORM
values obtained during the decollating process.

Figure 405 OVERRIDE Parameter Format

Optional. Parameter OVERRIDE consists of the four subparameters listed below. If

any subparameter is defined, it supersedes the corresponding value obtained during
decollation for all reports printed by this mission.

NOTE
This parameter applies to printing missions only.

Table 260 OVERRIDE Subparameters

Subparameter Description
CLASS Output printing class.
DEST Local or remote printer JES destination (node and user ID) for printing
the report.

If CONTROL-D for Distributed Systems (a separately licensed

product) is installed, reports can be distributed to a Unix or Windows
NT environment by setting the node value in this parameter to CTDS.
For details, see CONTROL-D for Distributed Systems on page 286.
EXTWTR External writer name.
FORM Form to use when printing the report.

General Information
Parameter OVERRIDE can be specified for printing missions which run under a
printing monitor and for printing missions which run under a batch job.

706 CONTROL-D and CONTROL-V User Guide

 OVERRIDE: General Parameter

If a printing mission is run under a batch job (because parameter BATCH is set to Y)
and subparameter FREE is set to END, all of the chunks produced by the printing
mission should be in one JES outgroup. Otherwise, SYSOUTS might not be printed in
the correct order. To ensure that all SYSOUTS are in the same JES outgroup, they
must have the same CLASS, DEST and EXTWTR (external writer name). Parameter
OVERRIDE can be used for setting these characteristics.

For more information about subparameter FREE, see parameter BATCH in this
chapter. For more information about chunking, see the CONTROL-D and
CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

Example
Use the laser printer to print end-of-year interest earnings on tax form 1099.

Figure 406 OVERRIDE Parameter Example

---- CONTROL-D CATEGORY IRS1099 PRT MISSION FM1099 --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
======= >>>>>>>>>>>>>>>>>>> TOP OF CATEGORY PARAMETERS <<<<<<<<<<<<<<<<<< =====
CATEGORY INTEREST MISSION FM1099 MONITOR
OWNER N54A TASKTYPE PRT GROUP ACCTG
BATCH Y SKELETON FM1099 FREE CLOSE TIMEOUT
OVERRIDE CLASS W DEST LASER1 EXTWTR FORM 1099
WRITER OPTION
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ :
===========================================================================
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 12.33.31

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 707

OWNER: General Parameter

OWNER: General Parameter

User who requests CONTROL-V services.

Figure 407 OWNER Parameter Format

Mandatory. Parameter OWNER must be 1 through 8 characters.

General Information
Parameter OWNER is used by CONTROL-Vs internal security mechanism to
determine which operations each user is authorized to perform.

Parameter OWNER also facilitates the handling of production missions. When using
the Online facility, you can restrict the display of CONTROL-V information to
specified users.

Parameter OWNER is passed to external security products such as RACF, TOP

SECRET and ACF2.

Default OWNER is dependent on the sites online environment (CICS, TSO, and so
on). For TSO and TSO/ISPF environments, the TSO user ID is the default. For
non-TSO environments, such as CICS, the default is the terminal ID.

Example
Category DAILY of backup mission BKP0031D belongs to owner M22.

708 CONTROL-D and CONTROL-V User Guide

 OWNER: General Parameter

Figure 408 OWNER Parameter Example

---- CONTROL-D CATEGORY DAILY BKP MISSION BKP0031D --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION BKP0031D
OWNER M22 TASKTYPE BKP GROUP DAILY-BKP
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC BACKUP REPORTS FOR 31 DAYS
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN OP-START-BACKUP-031D ODAT
TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
# OF DAYS TO KEEP 00031 # OF GENERATIONS TO KEEP
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 12.53.58

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 709

PDS: Basic Scheduling Parameter

PDS: Basic Scheduling Parameter

Partitioned data set (library) that should be checked for the minimum number of
required free tracks (specified in parameter MINIMUM). See also MINIMUM.

Figure 409 PDS Parameter Format

Optional; however, if MINIMUM is specified, PDS is mandatory. Parameter PDS

specifies a data set name of 1 through 44 characters.

Parameter PDS cannot be used with any of the following parameters: DAYS,
WDAYS, MONTHS, CONFCAL, RETRO and DATES.

NOTE
This parameter is supported for compatibility with previous versions.

General Information
The data set must be cataloged, and it must be a partitioned dataset.

Parameters MINIMUM and PDS are always used together and are never used with
other Basic Scheduling parameters.

Parameter PDS identifies a library. Parameter MINIMUM specifies the minimum

number of free tracks required by that library.

These parameters are intended for use (definition) in missions which issue a warning
message if the minimum number of free tracks is not available.

710 CONTROL-D and CONTROL-V User Guide

 PDS: Basic Scheduling Parameter

If parameters MINIMUM and PDS are defined for a mission, the scheduling of the
mission is not related to or dependent upon any date criteria. Instead, the mission is
scheduled if the actual number of free tracks available in the specified library is below
the specified minimum when the New Day procedure is run at time of daily mission
ordering. The mission can then issue the appropriate warning.

NOTE
PDS does not work with PDSE-type libraries because they always appear to be 100 percent
full.

Example
Schedule the mission when library ALL.PARMLIB has less than 20 unused tracks.

Figure 410 PDS Parameter Example

---- CONTROL-D CATEGORY PDS PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY PDS MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP PDS-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC PARMLIB HAS LESS THAN 20 TRACKS
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ :
===========================================================================
DAYS 02,04,06 DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 03
MINIMUM 020 PDS ALL.PARMLIB
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 711

PRINTER: Mission-specific Parameter

PRINTER: Mission-specific Parameter

Logical name of the printer on which the mission can print.

Figure 411 PRINTER Parameter Format

NOTE
This parameter applies to printing missions only.

Table 261 PRINTER Subparameters

Subparameter Description
PRINTER A logical printer name of 1 through 20 characters. The printer name
must be defined in the CONTROL-D installation parameters. Multiple
printers can be specified. Optional.
DEST Valid JES destination. It consists of a node value and a user ID value,
each 1 through 8 characters. One or two DEST values can be specified.
Optional.

Under JES3, the DEST value can be a valid JES printing destination or
the JNAME of the printer which is defined as ANYLOCAL to JES.
CHUNKSIZE Number of lines per chunk sent to the spool for printing. This
parameter overrides the default chunksize specified for the printer
during CONTROL-D installation. Default: 10000. Optional.

General Information
When parameter PRINTER, DEST or CHUNKSIZE is specified, an identical
parameter line is displayed.

712 CONTROL-D and CONTROL-V User Guide

 PRINTER: Mission-specific Parameter

Parameter PRINTER enables you to specify which printers in the data center can print
the missions reports. Printers should be selected according to print needs (for
example, laser printers for special formatting; impact printers for carbon copies).
When multiple printers are specified, the printing mission determines which of the
specified printers are open but not currently in use, and then prints on the fastest of
these printers. If no printer is specified, the printer is selected from the printers
defined in the installation parameters.

Parameter DEST is optional and it should normally not be used. CONTROL-V uses
the destination (or JNAME for JES3) defined in the CONTROL-D installation
parameters. If another destination is specified in the User Reports list, it is assumed to
be a remote printer.

Entering CHUNKSIZE=0 or CHUNKSIZE=1 bypasses chunk processing. When

CHUNKSIZE=1, the entire bundle is sent to the spool for printing using the printing
characteristics of the first report in the bundle. This method can be used for printing
reports that contain identical printing characteristics.

When CHUNKSIZE=0, a separate chunk is produced for each destination. All

reports for a specific destination are contained in a single chunk.

For additional information about chunksize and printers control, see the
CONTROL-D and CONTROL-V chapter of the INCONTROL for z/OS Administrator
Guide.

Example
The bundle prints on one of the specified printers that is open and free. If both
printers are open and free, the bundle prints on the faster of the two printers.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 713

PRINTER: Mission-specific Parameter

Figure 412 PRINTER Parameter Example

---- CONTROL-D CATEGORY NORTH-COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
IN
TIME FROM TO NOT LATER THAN PRIORITY
ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT
SHOUT WHEN TO URGN
MSG
PRINTER PRT1 DEST CHUNKSIZE
PRINTER PRT2 DEST CHUNKSIZE
PRINTER DEST CHUNKSIZE
ON FORM
REQUEST
======= >>>>>>> END OF PRINTING MISSION PARAMETERS OF THIS CATEGORY <<<<<< ====

PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 10.19.22

714 CONTROL-D and CONTROL-V User Guide

 PRIORITY: Runtime Scheduling Parameter

PRIORITY: Runtime Scheduling Parameter

Internal CONTROL-V mission priority.

Figure 413 PRIORITY Parameter Format

Optional. Parameter PRIORITY specifies a 1 or 2 character alphanumeric priority. The

default is blank, which is the lowest priority.

General Information
Priority helps determine the order in which missions in the Active Missions file are
processed.

Priority is determined in ascending order where: blank < A < Z < 0 < 9

In general, the mission with the highest priority code executes first if its other runtime
scheduling requirements are satisfied.

Example
The airport courier morning printing mission has priority 99 and should be executed
before all missions with lower (or unspecified) priorities. This assures that the airport
bundle prints as soon as it is ready.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 715

PRIORITY: Runtime Scheduling Parameter

Figure 414 PRIORITY Parameter Example

---- CONTROL-D CATEGORY AIRPORT-COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
IN
TIME FROM TO NOT LATER THAN PRIORITY 99
ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG PRINTING MISSION STD ENDED NOTOK
SHOUT WHEN TO URGN
MSG
PRINTER PRT1 DEST CHUNKSIZE
PRINTER PRT2 DEST CHUNKSIZE
PRINTER DEST CHUNKSIZE
ON FORM
REQUEST
======= >>>>>>> END OF PRINTING MISSION PARAMETERS OF THIS CATEGORY <<<<<< ====

PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 10.19.22

716 CONTROL-D and CONTROL-V User Guide

 RETENTION DAYS: Mission-specific Parameter

RETENTION DAYS: Mission-specific Parameter

Number of days to keep the target files of a migration mission.

Figure 415 RETENTION DAYS Parameter Format

NOTE
This parameter applies to migration missions only.

Table 262 RETENTION DAYS Subparameters

Subparameter Description
RETENTION DAYS Enter a 5-digit number from 00001 through 65365. Leading zeros are
inserted automatically. If set to 9999, target files of the migration
mission is not deleted automatically; otherwise, target files of the
migration mission are subject to deletion after the specified number
of retention days have passed. Mandatory.
FORCE If the retention period of a migration mission is changed, this
parameter determines whether or not the retention period of
reports previously migrated by that migration mission is also
changed. Optional. Valid values are:

Y (Yes)Modify the retention period of all reports previously

migrated by the migration mission. A confirmation window is
displayed when exiting the Migration Mission Definition
screen.

N (No)Do not modify the retention period of previously

migrated reports. Default.

General Information
This parameter specifies the length of time the migrated report remains on a storage
device before it is reported as unnecessary. A nonzero value must be specified.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 717

RETENTION DAYS: Mission-specific Parameter

Utility CTVCLMIG produces a list of all CDAM and index files whose RETENTION
DAYS have expired. These out of date files are automatically deleted or
uncataloged. For more information about utility CTVCLMIG, see the INCONTROL
for z/OS Utilities Guide.

Utility CTDUPBKP can be used to update the retention period in Migrated or Active
Report files. For information about utility CTDUPBKP, see the INCONTROL for z/OS
Utilities Guide.

Example
Target files of the migration mission are subject to deletion 20 days after the date the
files were migrated.

Figure 416 RETENTION DAYS Example

---- CONTROL-V CATEGORY AAAA MIG MISSION MIGLIM --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
STAGE 01 SCHEDULING PARAMETERS
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
OUT
SHOUT WHEN TO URGN
MSG
===========================================================================
RETENTION DAYS 0020 FORCE N SECONDARY SKELETON MICLIM
===========================================================================
STAGE 01 PRIMARY MEDIA NAME DISK AGE 0010 REFRESH EVERY
PREFIX
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 11.27.56

718 CONTROL-D and CONTROL-V User Guide

 RETRO: Basic Scheduling Parameter

RETRO: Basic Scheduling Parameter

Flag that indicates whether or not the mission should be scheduled after its original
scheduling date has passed.

Figure 417 RETRO Parameter Format

Optional. Valid values are:

Table 263 RETRO Parameter Values

Value Description
Y (Yes) Retroactively schedule the mission as described below.
N (No) Do not retroactively schedule the mission. Default.

General Information
Parameter RETRO is used to control situations where the computer has not been
working for a day or more due to hardware failure or holiday, and so on.

When such situations occur, it is necessary to instruct CONTROL-V whether or not

the mission should be retroactively scheduled for the days when the computer (or
CONTROL-V) was inactive. For printing, migration and backup missions, RETRO=Y
should only be used if the job which creates the reports is to be run for the days that
the computer was down.

When RETRO=Y, missions are placed on the Active Mission file for all days the
mission should have been originally scheduled. Scheduling occurs from the last
scheduling date to the current working date, only if that those days were included in
one of the scheduling parameters (DAYS, DCAL, and so on). Each mission placed on
the Active Missions file is associated with a different original scheduling date. For
additional information, see parameter MAXWAIT.

When RETRO=N, the mission is only scheduled for the current working date, only if
that the mission is normally scheduled for that date.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 719

RETRO: Basic Scheduling Parameter

RETRO cannot be used with parameters MINIMUM and PDS.

Examples

Example 1

Schedule the printing mission only on specified days of the month. If the date has
passed, do not schedule the mission.

Figure 418 RETRO Parameter Example 1

---- CONTROL-D CATEGORY SPECIAL PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY SPECIAL MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP SPECIAL-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC BUNDLE FOR ALL RECIPIENTS
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 1,3
===========================================================================
DAYS 06,13,20,27 DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES 2106 2112
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

Assume that the computer was offline from the 5th to and including the 7th. The
mission is not run for the 6th. The next time the mission executes is on the 13th.

Example 2

Schedule the backup mission for every Tuesday. If the computer is down on Tuesday,
execute the mission on the day the computer resumes operations.

720 CONTROL-D and CONTROL-V User Guide

 RETRO: Basic Scheduling Parameter

Figure 419 RETRO Parameter Example 2

---- CONTROL-D CATEGORY WEEKLY BKP MISSION BKP0180D --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY WEEKLY MISSION BKP0180D
OWNER M22 TASKTYPE BKP GROUP WEEKLY-BKP
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC WEEKLY BACKUP OF REPORTS FOR 180 DAYS
DESC
===========================================================================
DAYS DCAL
AND/OR
WDAYS 2 WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO Y MAXWAIT 08
MINIMUM PDS
===========================================================================
IN OP-START-BACKUP-031D ODAT
TIME FROM TO NOT LATER THAN PRIORITY
===========================================================================
# OF DAYS TO KEEP 00180 # OF GENERATIONS TO KEEP
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 12.53.58

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 721

SECONDARY SKELETON: Mission-specific Parameter

SECONDARY SKELETON: Mission-specific

Parameter
Name of the member that contains a skeleton job for creating a second copy of
migrated files.

Figure 420 SECONDARY SKELETON Parameter Format

NOTE
This parameter applies to migration missions only.

2 through 8 characters. This parameter defaults to the name of the primary migration
mission (see parameter MISSION in this chapter of the guide), modified by changing
the 3rd character to C (or to D if it had been C). (If the value of parameter MISSION is
a single character, C is added as a 2nd character.) This default name can be modified
by typing over it.

General Information
If secondary migration is implemented for any stage in the migration path, the
migration skeleton library must contain a member whose name is identical to the
value specified in this parameter.

If parameter SECONDARY MEDIA is specified in any stage of the migration path,

the migration mission produces two jobs: the first job uses the migration skeleton
whose name is identical to the name of the primary migration mission. The second
job uses the migration skeleton whose name is specified in this parameter.

NOTE
If parameter SECONDARY MEDIA is not specified anywhere in the migration path, this
parameter is ignored.

722 CONTROL-D and CONTROL-V User Guide

 SECONDARY SKELETON: Mission-specific Parameter

Example
Migration mission MIGSEC submits two migration jobs. The primary migration job
uses skeleton MIGSEC to migrate the reports to OSS. The secondary migration job
uses skeleton MICSEC to migrate a second copy of the reports to cartridge. For more
information about migration mission logic, see the CONTROL-D and CONTROL-V
chapter of the INCONTROL for z/OS Administrator Guide.

Because parameter FORCE is set to Y, the retention period of reports previously

migrated by migration mission MIGSEC is modified to the number of days now
specified in RETENTION DAYS.

Figure 421 SECONDARY SKELETON Parameter Example

---- CONTROL-V CATEGORY MIGSEC MIG MISSION MIGSEC --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY MIGCAT MISSION MIGSEC
OWNER M15A TASKTYPE MIG GROUP
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC MIGRATE TO OSS AND CART
===========================================================================
STAGE 01 SCHEDULING PARAMETERS
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN IN-CARD ODAT IN-CARD2 ODAT
IN
TIME FROM 0010 TO 1200 NOT LATER THAN 1258 PRIORITY 09
===========================================================================
OUT OUT-CARD ODAT +

SHOUT WHEN NOTOK TO OPER2 URGN R

MSG MIGRATION MISSION MIGSEC STAGE 01 ENDED NOTOK
===========================================================================
RETENTION DAYS 0730 FORCE Y SECONDARY SKELETON MICSEC
===========================================================================
STAGE 01 PRIMARY MEDIA NAME OSS AGE 0005 REFRESH EVERY
PREFIX
SECONDARY MEDIA NAME CART REFRESH EVERY
===========================================================================
======= >>>>>>> END OF MIGRATE MISSION PARAMETERS OF THIS CATEGORY <<<<<< =====

PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 12.12.05

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 723

SHOUT: Post-Processing Parameter

SHOUT: Post-Processing Parameter

Message to be sent (shouted) to a specified destination when a specific situation
occurs.

Figure 422 SHOUT Parameter Format

Optional. Upon filling in the SHOUT statement and pressing Enter, a new SHOUT
statement is opened.

Each SHOUT statement consists of four mandatory subparameters: WHEN

(situation), TO (destination), URGN (urgency), and MSG (message text).

Table 264 SHOUT Subparameters (part 1 of 3)

Subparameter Description
WHEN Situation in which to send the message. Valid values are:

OK The message is sent if the mission ends OK.

NOTOK The message is sent if the mission ends NOTOK.
LATE time The message is sent if the mission does not finish
executing by the specified time, where time is in the format
hhmm.

724 CONTROL-D and CONTROL-V User Guide

 SHOUT: Post-Processing Parameter

Table 264 SHOUT Subparameters (part 2 of 3)

Subparameter Description
EXECTIME limit The message is sent if the jobs elapsed
runtime is outside a specified limit. The limit can be expressed as
a runtime limit, or as a deviation from the jobs average runtime.
Valid formats for limit are (where n is a 3-digit nonzero value):
>n Jobs elapsed runtime is greater than n minutes.
n cannot exceed 999.
<n Jobs elapsed runtime is less than n minutes.
n cannot exceed 999.
+n Jobs elapsed runtime exceeds the jobs average
execution time by at least n minutes. n cannot
exceed 999.
n Jobs elapsed runtime is at least n minutes less than
the jobs average execution time. n cannot exceed
999.
+n% Jobs elapsed runtime exceeds the jobs average
execution time by at least n%. n cannot exceed
900.
n% Jobs elapsed runtime is at least n% less than the
jobs average execution time. n cannot exceed 99.
TO Destination of the message (1 through 16 characters). Mandatory.
Valid values are:

U-userid or USERID-userid Writes the message to the IOA Log

file under the specified user ID. userid must be 1 through 8
characters.

OPER[n] Sends a rollable message to the operator console. n is

an optional 2-digit route code. If a route code is not specified, the
default routes are Master Console and Programmer Information
(1 and 11). For more detailed information regarding route codes,
refer to the IBM publication Routing and Descriptor Codes,
GC38-1102.

OPER2[n] Sends an unrollable, highlighted message to the

operator console. n is an optional 2-digit route code. If a route
code is not specified, the default routes are Master Console and
Programmer Information (1 and 11). For more detailed
information regarding route codes, refer to the IBM publication
Routing and Descriptor Codes, GC38-1102.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 725

SHOUT: Post-Processing Parameter

Table 264 SHOUT Subparameters (part 3 of 3)

Subparameter Description
TSO - loginid [;Nn | ;Mm | ;NnMm | ;Lname] Sends the message
to the specified ID (logonid). ID is mandatory (1 through 7
characters).
An optional second value, indicating the computer and/or node
(such as Mm) of the TSO logonid, can be specified, as follows:
Under JES2:
Valid values are Nn, Mm or NnMm, where:
m is the machine ID (the computer in JES2, not the
4-character SMF system ID). For more information, see
Specify IOA CPUs under Customization Process in the
Installing IOA chapter of the INCONTROL for OS/390
and z/OS Installation Guide.
n is the 1 to 2 character JES/NJE node ID.
Under JES3:
The only valid value is Lname, where Lname is the logical JES
name of the machine (that is, the name as used in JES3 command
*T, not the SMF system ID.
For more information, see Specify IOA CPUs under
Customization Process in the Installing IOA chapter of the
INCONTROL for z/OS Installation Guide.
Note: A shout to a TSO user performs a TSO SEND command, which
may require authorization at the receiving node.
URGN Determines the priority level of the message. Valid values are:
R - Regular. Default.
U - Urgent.
V - Very urgent.

MSG Message text. Maximum length: 70 characters.

AutoEdit variables (both system and user-defined) are supported and

automatically resolved (replaced) at the time the SHOUT message is
issued. For AutoEdit usage information see Chapter 6 and Appendix
C.

General Information
The message is sent to the specified destination when the WHEN condition is
satisfied. Multiple SHOUT statements can be evaluated and performed
independently.

Subparameter TO

Enter TO=USERID-userid, to write the message to the IOA Log file under the user ID
specified in the parameter.

726 CONTROL-D and CONTROL-V User Guide

 SHOUT: Post-Processing Parameter

Enter TO=OPER[n], to send the message to the operator console (route code n). If the
n value is omitted, the message is sent to all consoles to which route codes 1 or 11 are
assigned. For more detailed information regarding route and descriptor codes, refer
to the IBM publication Routing and Descriptor Codes, GC38-1102.

Enter TO=OPER2[n], to send a highlighted, unrollable message is sent to the

operator console (route code n). If the n value is omitted, the message is sent to all
consoles to which route codes 1 or 11 are assigned. For more detailed information
regarding route and descriptor codes, refer to the IBM publication Routing and
Descriptor Codes, GC38-1102.

Enter TO=TSO-id or T-id, to send the message is sent to the logonid. The Shout
facility first searches the IOA Dynamic Destination table for the specified ID. If the
table contains an entry that matches the value, the entrys content is used as the target
for the shouted message. (The entire TO field is used. Therefore, when directing the
message to a remote user, do not append Nn or Mm. Instead, do this in the IOA
Dynamic Destination table itself). For more information, see Dynamic Destination
Table in the IOA administration chapter of the INCONTROL for z/OS Administrator
Guide.

If no matching ID is found in the Dynamic Destination table, the Shout facility

assumes the specified ID is a logonid. It then creates a TSO message that it hands over
to MVS. MVS then sends the message to that logonid. (If the logonid does not exist,
MVS cannot send the message, but no error message is generated.) When a second
value is used, the message is sent to the TSO logonid in the specified computer or
node (machine ID). To determine the machine ID under JES2, enter JES command
$LSYS.

Subparameter URGN

The URGN value indicates the urgency level of the message.

In addition, if the destination is USERID-userid (or U-userid), the user can control,
according to urgency, which messages are displayed when the IOA Log file is
accessed. Urgent and very urgent messages are highlighted on the screen. For more
details, see IOA Log Facility in Chapter 2.

Example
If the printing mission does not finish executing successfully, send an urgent
unrollable, highlighted message to the operator console.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 727

SHOUT: Post-Processing Parameter

Figure 423 SHOUT Parameter Example

---- CONTROL-D CATEGORY AIRPORT-COURIER PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
===========================================================================
IN
TIME FROM TO NOT LATER THAN PRIORITY 90
ON PAGE# ON LINE# INTERVAL
===========================================================================
OUT AIRPORT-PRINTED ODAT +
SHOUT WHEN NOTOK TO OPER2 URGN U
MSG PRINTING MISSION STD - CATEGORY "AIRPORT" ENDED NOTOK
SHOUT WHEN TO URGN
MSG
PRINTER PRT1 DEST CHUNKSIZE
PRINTER PRT2 DEST CHUNKSIZE
PRINTER DEST CHUNKSIZE
ON FORM
REQUEST
======= >>>>>>> END OF PRINTING MISSION PARAMETERS OF THIS CATEGORY <<<<<< ====

PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 10.19.22

728 CONTROL-D and CONTROL-V User Guide

 SORT: Printing Mission Bundling Parameter

SORT: Printing Mission Bundling Parameter

Sort keys for sorting reports within a bundle.

Figure 424 SORT Parameter Format

Optional. Default: sort by code 6 (Recipient Tree).

NOTE
Parameter SORT applies to printing missions only.

Codes (1 through 9, T, E) corresponding to the desired sort keys are typed in the
ENTER SORT SEQ field. The primary sort key should be entered first, followed by
any secondary sort keys. The codes must be separated by commas.

For each sort key, a sort order (A = ascending, D = descending) may optionally be
specified. The default is sort in ascending order. Example: 5D, 1, 3.

General Information
CONTROL-V sorts the reports included in a printing mission based on the specified
sort keys.

Table 265 SORT Parameter Sort Keys (part 1 of 2)

Key Description
1 User name, as specified in parameter DO USER in the Report Decollating
Mission screen.
2 Name of the job that created the report.
3 Report name, as specified in parameter DO NAME in the Report Decollating
Mission screen.
4 Category of the reports decollating mission.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 729

SORT: Printing Mission Bundling Parameter

Table 265 SORT Parameter Sort Keys (part 2 of 2)

Key Description
5 Level of the user, as specified in the Recipient Tree.
6 Recipient Tree order.
7 FORMS printing characteristics.
8 CHARS printing characteristics.
9 MODIFY printing characteristics.
T Decollation time and date.
E A field whose value is set by user Exit CTDX020.

Table 266 SORT Order Keys

Key Description
A Sort in ascending order. Default.
D Sort in descending order.

NOTE
Sort criteria can affect printing speed.

When sort key 6 is specified, reports are sorted according to Recipient Tree structure.
All reports belonging to a particular tree branch are printed before any reports
from an alternate branch. The order within a Recipient Tree is illustrated below:

730 CONTROL-D and CONTROL-V User Guide

 SORT: Printing Mission Bundling Parameter

Figure 425 Sort Order in a Recipient Tree Example

Example
Sort the reports based on user name, using report name (in descending order) as a
secondary key.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 731

SORT: Printing Mission Bundling Parameter

Figure 426 SORT Parameter Example

---- CONTROL-D CATEGORY DAILY PRT MISSION STD --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION STD MONITOR
OWNER M22 TASKTYPE PRT GROUP DAILY-PRT
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC DAILY BUNDLE FOR ALL RECIPIENTS
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ : 1,3D
===========================================================================
DAYS DCAL
AND/OR
WDAYS ALL WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8 Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.49.35

732 CONTROL-D and CONTROL-V User Guide

 STAGE: Mission-specific Parameter

STAGE: Mission-specific Parameter

Migration path safe specifications: Target media name, report age when migration
occurs, cyclic interval for refresh operations, and specific parameters for each media
type.

Figure 427 STAGE Parameter Format

NOTE
These parameters apply to migration missions only. Migration stage 01 is mandatory.

Table 267 STAGE Subparameters (part 1 of 2)

Subparameter Description
STAGE Migration stage number from 01 through 10. The value is inserted
automatically. Migration stages are specified in numerical order. If
you specify anything in this field, it changes automatically to the
correct number.
PRIMARY MEDIA Name of the target media for the primary migration mission. This
name must be one of the names specified in installation parameter
MEDIA NAME in the IOASPRM member. Mandatory.
AGE Age of the report in days when migration should occur. The value
specified for each stage must be larger than the value in parameter
AGE plus the value (if any) in parameter REFRESH for the
preceding stage. The specified value must be less than the value in
parameter RETENTION DAYS. Mandatory.
REFRESH Cyclic time interval in days for triggering refresh operations that
copy migration reports and their indexes to a new target physical
media of the same type. Optional.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 733

STAGE: Mission-specific Parameter

Table 267 STAGE Subparameters (part 2 of 2)

Subparameter Description
CTLG Determines whether the migrated CDAM and Index files are
cataloged. Optional. Valid values are:

Y (Yes) The migrated files are cataloged. Default.

N (No) The migrated files are not cataloged. You can only use
this option for CART media.
PREFIX Prefix of the volume or platter to which files are migrated. This
parameter is only displayed when parameter MEDIA is set to a
value assigned to media type DASD or OSS. Optional.
FSET File set of the storage machine to be used for the migration mission.
This parameter is only displayed when MEDIA is set to a value
assigned to media type FTK. If not specified, the FileTek storage
machine default is used. Optional.
VSET Volume set of the storage machine to be used for the migration
mission. This parameter is only displayed when MEDIA is set to a
value assigned to media type FTK. If not specified, the FileTek
storage machine default is used. Optional.
SECONDARY MEDIA Name of the target media for the secondary migration mission. This
name must be one of the names specified in installation parameter
MEDIA NAME in the IOASPRM member. Optional.

General Information
One set of STAGE parameters is displayed for stage 01 migration from disk to
another media. Another set of STAGE parameters is displayed as each migration
stage is defined. A maximum of 10 sets of STAGE parameters can be specified.

Each set of STAGE parameters is divided into two parts: primary migration and
secondary migration. For each stage that is specified, primary migration is mandatory
and secondary migration is optional. The value specified in parameter AGE for a
stage applies to both primary and secondary migration in that stage.

Primary migration uses parameter DSNPREF in the IOASPRM member. Secondary

migration uses parameter SECPREF in the same macro.

By default, users access the files produced by primary migration. Utility CTDUPBKP
can be used to switch user access between the files produced by primary and
secondary migration. For more information about the work flow of migration
missions, see the CONTROL-D and CONTROL-V chapter of the INCONTROL for
z/OS Administrator Guide.

734 CONTROL-D and CONTROL-V User Guide

 STAGE: Mission-specific Parameter

Parameter PREFIX is only displayed if parameter MEDIA NAME is set to a media

that is assigned to media type DASD or OSS in the IOASPRM member. Parameters
FSET and VSET are only displayed if parameter MEDIA NAME is set to a media that
is assigned to a FileTek storage machine in member IOASPRM. The number of days
specified in parameter REFRESH EVERY should be set according to the
manufacturers recommendations for the physical media and the values specified in
parameters AGE and RETENTION DAYS.

Example
Figure 428 STAGE Parameter Example
| =========================================================================== |
| RETENTION DAYS 03000 FORCE N SECONDARY SKELETON MICLIM |
| =========================================================================== |
| STAGE 01 PRIMARY MEDIA DISK AGE 00010 REFRESH CTLG |
| PREFIX VOLDP |
| SECONDARY MEDIA REFRESH CTLG |
| =========================================================================== |
| =========================================================================== |
| STAGE 02 PRIMARY MEDIA FTK1 AGE 00030 REFRESH CTLG |
| FSET MAGDISK VSET MAGDISK |
| SECONDARY MEDIA FTK2 REFRESH CTLG |
| FSET OPTICAL VSET OPTICAL |
| |
| STAGE 03 PRIMARY MEDIA OSS2 AGE 00300 REFRESH CTLG |
| PREFIX PLTD |
| SECONDARY MEDIA REFRESH CTLG |
| |
| STAGE 04 PRIMARY MEDIA CART AGE 00600 REFRESH 01500 CTLG N |
| SECONDARY MEDIA REFRESH CTLG |
| |
| STAGE 05 PRIMARY MEDIA AGE REFRESH CTLG |
| SECONDARY MEDIA REFRESH CTLG |
| =========================================================================== |

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 735

STORE: Mission-specific Parameter

STORE: Mission-specific Parameter

Yes/No indicator that specifies whether or not a new copy of the report should be
created and stored as a new report file with embedded print resources. If the report
has indexes, this indicator also specifies whether or not a new copy of the index file
should be created.

Figure 429 STORE Parameter Format

Table 268 STORE Subparameters

Subparameter Description
STORE Indicates whether to create a new report file with embedded print
resources. Optional. Valid values are:

Y (Yes) Create a new report file with embedded print resources.

If you enter this value,

you must either set APA to YES or set ACIF to YES in the
PRINT/CDAM PARMS in the decollation mission

the result is special handling of the printing mission, and the

BACKUP and MIGRATE subparameters become relevant

N (No) Do not create a new report file. Default.

BACKUP Name of the mission to backup the new report file. Optional. This
subparameter is relevant only if Y is entered for the STORE
parameter.
MIGRATE Name of the mission to migrate the new report file. Optional. This
subparameter is relevant only if Y is entered for the STORE
parameter.

NOTE
This parameter applies to printing missions only.

736 CONTROL-D and CONTROL-V User Guide

 STORE: Mission-specific Parameter

General Information
CONTROL-V can store AFPDS reports with their original print resources embedded
in a new report file. Embedding print resources in the report file ensures report
integrity. These reports are not affected by subsequent modifications to report format,
print resources, and the ACIF environment. The new report file can be viewed by
CONTROL-D/WebAccess Server users with the AFP viewer or the CompuView
Navigator under CONTROL-D/Page On Demand.

When parameter STORE is set to Yes, the printing mission does not send SYSOUT to
Spool and does not produce reports to be transferred to CONTROL-D/WebAccess
Server. Instead, it stores the print image as a new report and produces the following:

New CDAM file

New $SYSDATA records
New Active User Report entries pointing to the new CDAM file.

The new CDAM file is allocated according to parameters specified for

CONTROL-D/WebAccess Server in the CONTROL-V installation parameters (such
as PCBLKSZ, PCPREF, PCUNIT or PCVOLS).

In addition, the print mission creates CONTROL-V indexes based on predefined

ACIF index definitions. ACIF index definitions can be specified in the CONTROL-D
ACIFPARM libraries or can be included in the AFPDS report file. For more
information about converting ACIF main indexes to CONTROL-V hierarchical
indexes, see Parameter CTVINDEXnn in the CONTROL-D and CONTROL-V
chapter of the INCONTROL for z/OS Administrator Guide.

Subparameters BACKUP and MIGRATE are displayed on the same line after
parameter STORE. These subparameters optionally specify the name of the backup
and/or migration mission that backs up or migrates the stored AFP report.

The BACKUP and MIGRATE subparameters for the new report are the same as the
standard backup and migrate parameters specified for decollation missions. For more
information, see DO BACKUP: Decollating Parameter on page 452 and DO
MIGRATE: Decollating Parameter on page 481.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 737

TASKTYPE: General Parameter

TASKTYPE: General Parameter

Type of mission to be executed.

Figure 430 TASKTYPE Parameter Format

Mandatory. Valid TASKTYPE values are:

Table 269 TASKTYPE Values Migration Missions

Value Description
MIG Migration mission
EMG Emergency migration mission

Table 270 TASKTYPE Values Printing Missions

Value Description
PRT Printing mission
EPR Emergency printing mission
CPR Cyclic printing mission
ECP Emergency cyclic printing mission

Table 271 TASKTYPE Values Backup Missions

Value Description
BKP Backup mission
EBK Emergency backup mission

Table 272 TASKTYPE Values Restore Missions (part 1 of 2)

Value Description
RST Restore mission
ERS Emergency restore mission

738 CONTROL-D and CONTROL-V User Guide

 TASKTYPE: General Parameter

Table 272 TASKTYPE Values Restore Missions (part 2 of 2)

Value Description
CRS Cyclic restore mission
RSM Restore migrated mission
ERM Emergency restore migrated mission
CRM Cyclic restore migrated mission

General Information
A standard mission (MIG, PRT, BKP, RST, or RSM) should be used for regular
production missions.

An emergency mission (EMG, EPR, EBK, ERS, or ERM) should be used for
emergency production events.

A cyclic mission (CPR, CRS, or CRM) usually accumulates requests from various
users and performs them at intervals (for example, every two hours). After a cyclic
mission has finished executing, it returns to WAIT SCHEDULE state. It then executes
again depending on its runtime scheduling criteria.

A cyclic printing mission is often used when the CONTROL-V monitors primary use
is sysout printing. In such a case, it is common to activate a cyclic printing mission
that wakes up every few minutes, and prints reports which were captured from the
spool since the last invocation of the cyclic printing mission.

It is possible to retrieve regular cyclic, cyclic or emergency missions selectively when

using the Online facility. This provides an additional means of control.

Emergency missions remain in the Active Missions file until all regular missions of
the same GROUP finish executing OK. When an emergency mission is no longer
needed, it is removed from the Active Missions file. This process is performed once a
day by the CONTROL-V New Day procedure. For details, see the CONTROL-D and
CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

NOTE
BMC Software recommends that parameter GROUP be specified if you define emergency
missions. If GROUP is not specified, the mission may remain indefinitely in the Active
Missions file.

Parameter ON PAGE# can be used to trigger (cyclic) printing missions when the
number of pages waiting to be printed exceeds a specified threshold.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 739

TASKTYPE: General Parameter

Example
Cyclic restore mission RST0120M implements all accumulated restore requests every
two hours.

Figure 431 TASKTYPE Parameter Example

---- CONTROL-D CATEGORY DAILY RST MISSION RST0120M --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION RST0120M
OWNER M22 TASKTYPE CRS GROUP DAILY-RST
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC BI-HOURLY RESTORE MISSION
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
TIME FROM TO NOT LATER THAN PRIORITY INTERVAL 120
===========================================================================
OUT
SHOUT WHEN NOTOK TO OPER2 URGN R
MSG RESTORE MISSION RSTADHOC ENDED NOTOK
SHOUT WHEN TO URGN
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.47.59

740 CONTROL-D and CONTROL-V User Guide

 TIME: Runtime Scheduling Parameter

TIME: Runtime Scheduling Parameter

Time limits (FROM, TO) during which the mission can be executed.

Figure 432 TIME Parameter Format

Optional Parameter TIME consists of subparameter FROM and TO. Either or both
subparameters can be specified.

The FROM and TO fields can contain valid times in the format hhmm (where hh is
hour and mm is minute).

General Information
Normally, CONTROL-V submits the mission only during the time interval defined in
parameter TIME (that is, the mission is not submitted before the time specified in the
FROM field and is not submitted after the time specified in the TO field).

When either a FROM or a TO value is not specified, the default is used. The default
values are the start and end of the work day as determined by the New Day
procedure.

Examples

Example 1

Execute the mission only between 9 P.M. and 6 A.M.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 741

TIME: Runtime Scheduling Parameter

Figure 433 TIME Parameter Example 1

---- CONTROL-D CATEGORY DAILY BKP MISSION BKP0031D --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION BKP0031D
OWNER M22 TASKTYPE BKP GROUP DAILY-BKP
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC BACKUP REPORTS FOR 31 DAYS
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
TIME FROM 2100 TO 0600 NOT LATER THAN PRIORITY
===========================================================================
# OF DAYS TO KEEP 00031 # OF GENERATIONS TO KEEP
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 12.53.58

Example 2

Execute the mission after 7:00 a.m.

TIME FROM 0700

Example 3

Execute the mission after midnight.

742 CONTROL-D and CONTROL-V User Guide

 TIME: Runtime Scheduling Parameter

Figure 434 TIME Parameter Example 3

---- CONTROL-D CATEGORY DAILY RST MISSION RSTADHOC --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY DAILY MISSION RSTADHOC
OWNER M22 TASKTYPE RST GROUP DAILY-RST
BATCH SKELETON FREE TIMEOUT
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC AD-HOC RESTORE MISSION
DESC
===========================================================================
DAYS ALL DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
IN
TIME FROM 0000 TO NOT LATER THAN PRIORITY INTERVAL 060
===========================================================================
OUT
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.47.59

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 743

TIMEOUT: Mission-specific Parameter

TIMEOUT: Mission-specific Parameter

Number of minutes within which a printing mission must begin execution.

NOTE
This parameter applies to printing missions only.

Figure 435 TIMEOUT Parameter Format

NOTE
This parameter applies to printing missions only.

This parameter specifies the number of minutes (from 0 through 99) after a printing
mission is submitted within which the mission must begin execution. If the mission
does not start before the specified number of minutes have elapsed, the mission
terminates NOTOK. Optional. Default: 5 (minutes).

Example
This printing mission is submitted as a batch job using the JCL in member PRTSKL of
the CONTROL-D SKL library. Sysout files are freed as soon as they are printed. If the
printing mission does not begin executing within 15 minutes after it is submitted, the
mission terminates NOTOK.

744 CONTROL-D and CONTROL-V User Guide

 TIMEOUT: Mission-specific Parameter

Figure 436 TIMEOUT Parameter Example

---- CONTROL-D CATEGORY STD PRT MISSION PRT1 --------(M.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
CATEGORY STD MISSION PRT1 MONITOR
OWNER M33B TASKTYPE PRT GROUP
BATCH Y SKELETON PRTSKL FREE CLOSE TIMEOUT 15
OVERRIDE CLASS DEST EXTWTR FORM
WRITER OPTION
DESC
===========================================================================
INCLUDE USER
EXCLUDE USER
SORT PARAMETERS: 1-USER 2-JOB 3-REPORT NAME 4-CATEGORY 5-LEVEL 6-TREE
7-FORMS 8-CHARS 9-MODIFY T-TIME/DATE E-USER DEFINED
ENTER SORT SEQ :
===========================================================================
DAYS DCAL
AND/OR
WDAYS WCAL
MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
DATES
CONFCAL SHIFT RETRO N MAXWAIT 00
MINIMUM PDS
===========================================================================
PLEASE FILL IN MISSION PARAMETERS. USE "SHPF" TO SEE PFK DEFINITION 08.04.30

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 745

WDAYS: Basic Scheduling Parameter

WDAYS: Basic Scheduling Parameter

Days of the week on which the mission should be scheduled. See also CONFCAL and
DAYS.

Figure 437 WDAYS Parameter Format

Optional. Parameter WDAYS specifies days of the week on which missions should be
scheduled, only if other basic scheduling criteria are met.

Values for WDAYS can be specified alone, or they can be specified together with a
calendar specified in subparameter WCAL. WDAYS/WCAL can also be specified
together with DAYS/DCAL (described under DAYS earlier in this chapter).

WDAYS subparameters are described below:

Table 273 WDAYS Subparameters (part 1 of 2)

Subparameter Description
WDAYS Days of each week in the month on which to schedule a mission. (The
months in which to schedule missions are specified in parameter
MONTHS.) Various formats (described later) can be used to specify
WDAYS (for example, 3 means the 3rd day of the week, L2 means the
day before the last day of the week).
Note: At the time of installation, the INCONTROL administrator
selects either Sunday or Monday as the first day of the week. Your
INCONTROL administrator can tell you whether the week begins on
Sunday or Monday at your site.

The first six days of the week are coded 1 through 6. The last day of
the week is coded 0 (zero). All examples in this chapter assume
Monday is the first day of the week. In these examples, Monday = 1,
Tuesday = 2, ..., Saturday = 6 and Sunday = 0.

746 CONTROL-D and CONTROL-V User Guide

 WDAYS: Basic Scheduling Parameter

Table 273 WDAYS Subparameters (part 2 of 2)

Subparameter Description
WCAL Name of a calendar containing a predefined set of dates (referred to as
working days) on which a mission should be scheduled. A specified
value must be either a valid member name of 1 through 8 characters,
or an * to indicate that the calendar specified in parameter CONFCAL
should be used for scheduling. For more information about how to
define, use and modify calendars, see IOA Calendar Facility in
Chapter 2.

A calendar specified in WCAL does not have to exist when defining

parameter WDAYS. However, it must exist when the mission is being
scheduled.

Assuming all other basic scheduling criteria are met:

When WDAYS is specified without WCAL, the mission is scheduled on the

specified days of the week.

When WCAL is specified without WDAYS, the mission is scheduled on the

working days marked in the WCAL calendar.

When WDAYS and WCAL are both specified, scheduling depends on the
combination of working days defined in the calendar and the values and format of
parameter WDAYS (described below).

When both DAYS and WDAYS criteria are specified, scheduling depends on the
connecting AND/OR value specified. (For more information, see subparameter
AND/OR in parameter DAYS.)

Valid Formats for WDAYS

Valid formats for parameter WDAYS, and how they relate to WCAL, are described
below.

In the following non-periodic scheduling formats:

n is an integer from 1 through 6 or 0 (zero), where 1 = the first day of the week
(Sunday or Monday, depending on the standard at your site) and 0 = the last day
of the week (that is, Saturday or Sunday).

Multiple values can be expressed (separated by commas) in any order.

WCAL must not contain the name of a periodic calendar.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 747

WDAYS: Basic Scheduling Parameter

Table 274 Non-Periodic Scheduling Formats

Format Description
ALL All days of the week. If ALL is specified, other WDAYS values cannot be
specified with it.

If a WCAL calendar is not defined, schedule the mission on all days in the
week. If a WCAL calendar is defined, schedule the mission only on the
working days indicated in the calendar.
n,... Specific days of the week.

If a WCAL calendar is not defined, schedule the mission on the specified

days. If a WCAL calendar is defined, schedule the mission only when a day is
defined as a working day in both parameter WDAYS and the WCAL
calendar.
+n,... Days of the week in addition to the working days specified in the WCAL
calendar. WCAL is mandatory.
n,... Schedule the mission on all days except the nth day from the beginning of the
week. WCAL is mandatory.
>n,... Schedule the mission on the indicated day if it is a working day in the WCAL
calendar; otherwise, schedule the mission on the next working day (within
the next seven days) that is not negated by a n value in the parameter. If
none of those seven days is a working day, the mission is not scheduled. This
format is frequently used for holiday handling. WCAL is mandatory.
<n,... Schedule the mission on the indicated day if it is a working day in the WCAL
calendar; otherwise, schedule the mission on the last previous working day
(within the preceding seven days) that is not negated by a n value in the
parameter. If none of those seven days is a working day, the mission is not
scheduled. This format is frequently used for holiday handling. WCAL is
mandatory.
Dn,... Schedule the mission on the nth working day from the beginning of the week.
WCAL is mandatory. Use D0 or -D0 to refer to the 7th working day from the
beginning of the week.
Dn,... Schedule the mission on all working days except the nth working day from
the beginning of the week. WCAL is mandatory.
Ln,... Schedule the mission on the nth working day counting backward from the
end of the week. WCAL is mandatory.
Ln,... Schedule the mission on all working days except the nth working day
counting backward from the end of the week. WCAL is mandatory.
DnWm,... (Where m = 1 through 6). If WCAL is defined, schedule the mission on the nth
working day of the mth week of the month. If WCAL is not defined, schedule
the mission on the mth appearance of the nth day of the week during the
month. WCAL is optional. A maximum of 11 DnWm values can be specified.
Note: When specifying DnWm with a calendar in the WCAL field, do not
code n as 0. This may produce unpredictable results.

748 CONTROL-D and CONTROL-V User Guide

 WDAYS: Basic Scheduling Parameter

In the following periodic scheduling formats:

n is an integer from 1 through 6 or 0, and i is any valid period identifier (or * for all
periods).

WDAYS periodic identifiers are counted on a week by week basis. Calculations do

not cross week boundaries (unlike DAYS periodic identifiers that can cross month
boundaries).

The name of a periodic calendar must be specified in WCAL. Refer to IOA

Calendar Facility in Chapter 2 for details concerning periodic calendars.

Table 275 Periodic Scheduling Formats

Format Description
DnPi,... Schedule the mission on the nth day of period i in each week, from the
beginning of the week.
DnPi,... Schedule the mission on all days except the nth day of period i in each week,
from the beginning of the week.
LnPi,... Schedule the mission on the nth day of period i in each week, counting
backward from the last day of the week.
LnPi,... Schedule the mission on all days of period i except the nth day of period i in
each week, counting backward from the last day of the week.

General Information
Negative values take precedence over positive values when determining whether or
not a mission is scheduled on a certain date. If a negative value (such as format n,
Dn, Ln, DnPi, or LnPi) in either the DAYS or WDAYS field prevents a mission
from being scheduled on a date, the mission is not scheduled on that date even if a
positive value (such as Ln) would otherwise result in the mission being scheduled on
that date.

A maximum of eight periodic values (such as types DnPi, DnPi, LnPi, or LnPi) can
be specified in any desired order.

If periodic and non-periodic values are mixed when specifying parameter WDAYS,
processing depends on the calendar type specified in parameter WCAL:

If a non-periodic calendar is specified in the WCAL parameter, only non-periodic

values in the WDAYS parameter are processed; periodic values are ignored. In this
case, negative periodic values (that is, DnPi, LnPi) are also ignored and do not
supersede other values.

If a periodic calendar is specified in the WCAL parameter, all periodic values and
the negative non-periodic value -n in the WDAYS parameter are processed; all
nonnegative non-periodic values are ignored.

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 749

WDAYS: Basic Scheduling Parameter

When Ln and/or Dn values are specified in a week which overlaps two months, the
MONTHS value of the earlier month determines whether or not Dn or Ln values are
applied in the week:

If the first day of the week falls in a month with a MONTHS value of Y, all Dn and
Ln values in that week are applied, even those falling in the next or previous
month when that month has a MONTHS value of N.

If the first day of the week falls in a month with a MONTHS value of N, no Dn or
Ln values in that week are applied (not even if those falling in the next or previous
month when that month has a MONTHS value of Y).

Parameter MONTHS is ignored when periodic values are specified in parameter

WDAYS.

Parameter WDAYS cannot be used with parameters PDS and MINIMUM.

Examples
The examples in this chapter are based on the following assumptions:

The current month is January 2000.

Working days are defined in calendar WORKDAYS which contains the following
working days (indicated by Y) for January 2000:

---S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y

Periodic calendar PERIDAYS contains the following periodic definition for

January 2000. These examples assume that all other days of this calendar are blank.

---S-------------S-------------S-------------S-------------S---
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 + 1
B C A A B B C A A B B C A A B B C A A B B

Start of the week is defined as Monday. Weeks start on the following dates in
January 2000: 3rd, 10th, 17th, 24th, and 31st.

At the end of each example, asterisks in a January 2000 calendar indicate the days on
which the mission is scheduled.

Example 1

Schedule the mission on every Sunday and Monday.

750 CONTROL-D and CONTROL-V User Guide

 WDAYS: Basic Scheduling Parameter

WDAYS 0,1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 438 WDAYS Parameter Example 1

Example 2

Schedule the mission on all working days and on all Saturdays.

WDAYS +6
WCAL WORKDAYS

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 439 WDAYS Parameter Example 2

Example 3

Schedule the mission on Sunday, if it is a working day. If Sunday is not a working

day, schedule the mission on the first preceding working day that is not a Friday.

WDAYS <0,-5
WCAL WORKDAYS

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 440 WDAYS Parameter Example 3

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 751

WDAYS: Basic Scheduling Parameter

Example 4

Schedule the mission on the 1st Monday of the 1st week in the month.

WDAYS D1W1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 441 WDAYS Parameter Example 4

Example 5

Schedule the mission on all working days except Mondays and Fridays.

WDAYS -D1,-L1
WCAL WORKDAYS

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 442 WDAYS Parameter Example 5

Example 6

Each week, schedule the mission on the 1st day of period A in that week, and on all
days except the second day of period B in that week.

WDAYS D1PA,-D2PB
WCAL PERIDAYS

752 CONTROL-D and CONTROL-V User Guide

 WDAYS: Basic Scheduling Parameter

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 443 WDAYS Parameter Example 6

Example 7

Schedule the mission on each Monday and on the 1st day of the month.

DAYS 1
AND/OR OR
WDAYS 1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 444 WDAYS Parameter Example 7

Example 8

Schedule the mission on the 3rd day of the month only if it is a Monday.

DAYS 3
AND/OR AND
WDAYS 1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 445 WDAYS Parameter Example 8

Chapter 4 Migration, Printing, Backup and Restore Mission Parameters 753

WDAYS: Basic Scheduling Parameter

Example 9

Schedule the mission on the last Monday of the month.

DAYS L1,L2,L3,L4,L5,L6,L7
AND/OR AND
WDAYS 1

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 446 WDAYS Parameter Example 9

Example 10

Schedule the mission on the 1st, 7th and 15th day of the month if they are both
Saturdays and working days. If the day of the month (1st, 7th, 15th) is not a Saturday,
do not schedule the mission. If the day of the month is a Saturday, but it is not a
working day, schedule the mission on the next working day.

DAYS 1,7,15
AND/OR AND
WDAYS 6
CONFCAL WORKDAYS
SHIFT >

The mission is scheduled on the days of the month indicated by an asterisk:

Figure 447 WDAYS Parameter Example 10

754 CONTROL-D and CONTROL-V User Guide

 Chapter

5
Compressed Dataset Access Method
5

(CDAM)
This chapter contains the following topics:

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 756
How to Use CDAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759
Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759
Activating the CDAM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 759
CDAM Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 760
Parameter DSN of the DD Statement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 773
CDAM Logic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775
CDAM Dataset Naming Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 776
Multijob CDAM Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 777
CDAM User Exit CTDX018 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 779
Example 1. Order a Report Decollating Mission . . . . . . . . . . . . . . . . . . . . . . . . . . 780
Example 2. Add Lines to the Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 780
Example 3. Split a Report by Lines (Decollate by Line). . . . . . . . . . . . . . . . . . . . . 781
CDAM Maintenance Utility CTDAMUTI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 781
Activating the Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 782
Parameter Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 782
CDAM Maintenance Utility CTDAMUTI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 781
Migrated CDAM Datasets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785
Media and Resource Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 785
OSS Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786
FTK Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 786
CART Media. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 787

Chapter 5 Compressed Dataset Access Method (CDAM) 755

Overview

Overview
This chapter should be read very carefully. It deals with performance considerations
for managing large volumes of sysouts. Although CONTROL-V can be implemented
effectively using the conventional job writes reports to spool method, it is possible
to improve the efficiency of the data center by writing reports directly to compressed
datasets.

CONTROL-V can use two report processing techniques. The basic technique does not
require any JCL changes and can be implemented immediately on any given report.
The following diagram shows the basic report processing workflow:

Figure 448 CONTROL-V Basic Report Processing Workflow

The basic workflow is:

Jobs write reports to the JES spool.

CONTROL-V monitor reads the reports from the spool.

CONTROL-V monitor writes the reports to compressed datasets while deleting the
original copy from the JES spool.

The decollating process is carried out while the reports are moved from the spool
to the compressed datasets.

This type of process is reliable and is used by many report management systems.
However, it is not the best solution in terms of overall system performance. The
inherent problems of this method are:

756 CONTROL-D and CONTROL-V User Guide

 Overview

Redundant write operations. The same report is written to the spool, then it is read
from the spool and (again) written to compressed datasets. The writing of the
report to the spool is redundant because the report finally resides on compressed
datasets.

Use of the JES spool. This method is inefficient because:

The JES spool is a large pre-allocated DASD space. It must be large enough to
contain many of the largest reports. Since it is a pre-allocated area, that area
cannot be used for other purposes (for example, sort work areas) even when
spool utilization is low.

The data on the spool is not compressed and is not structured efficiently. This
results in a waste of space. A significant portion of the spool is full of blanks.

A sysout on the spool can be deleted (purged) very easily by indirect commands
(for example, an operator may delete the entire sysout output class). Therefore,
reports can disappear from the spool before they are printed and a rerun of the
job is required to recreate the report.

Most security products have serious problems protecting data on the spool.
Consequently, the spool is a potential security leak and sysouts on spool are not
protected using conventional security methods.

Although 100% spool utilization must be avoided at all costs, this situation can
occur very easily when many reports and dumps are written to the spool.

The JES spool is one of the most highly used components of the operating
system. Programmers access the spool frequently to scan the JES queues using
SDSF, FLASHER, ISPF, and TSO OUTPUT commands. The overhead for this
activity depends on the number for outputs on the spool. If the spool contains
unnecessary data, system overhead is unnecessarily increased.

The Compressed Dataset Access Method (CDAM) solves all of these problems. It also
has other benefits:

Reports are written directly to compressed sysout. They do not pass through the
spool, thereby avoiding redundant write operations.

The elapsed time of jobs which create large reports is reduced by 10% or more.

Since CDAM sysouts are written to specified units, there is no need for pre-
allocated space. The CDAM allocates space only when it is actually needed and
unused space is released for general use at the end of the job. There is no danger of
a SB37 abend (space shortage) unless the specified unit is completely full. It is
possible to define the entire free area in all the disks in the data center as one large
potential spool for CDAM.

Chapter 5 Compressed Dataset Access Method (CDAM) 757

Overview

The CDAM performs report compression. The compression rate is 30% to 70%
depending on the type of data.

A report stored in a compressed dataset is subject to all the security rules of the
installation since it is a regular sequential dataset. Multi-user access to a
compressed report is available only via the CONTROL-V Online interface, and
only to authorized users using regular dataset protection. The compression routine
also acts as an encryption mechanism.

The danger of 100% spool utilization is greatly reduced because large reports and
dumps (for example, from CICS) are no longer written to the spool.

Using CDAM, the number of sysouts on the spool is reduced; therefore, the
overhead related to spool operations is reduced.

The following diagram shows the report workflow using the Compressed Dataset
Access Method:

Figure 449 CONTROL-V Report Workflow Using the Compressed Dataset Access
Method

The recommended report processing workflow is:

Jobs write reports to compressed datasets.

CONTROL-V monitor reads the reports from the compressed datasets and
decollates them.

The CONTROL-V monitor uses compressed reports in both workflows. The means
by which CONTROL-V (or the user) can create and read compressed reports is called
the Compressed Dataset Access Method (CDAM).

758 CONTROL-D and CONTROL-V User Guide

 How to Use CDAM

CDAM is a general access method by which sysouts (reports) can be written to

compressed datasets. To invoke CDAM, the user must modify the JCL of the job so
that the reports are written to compressed datasets and not to the spool. There is no
need to change the application program which produces the reports.

The following paragraphs describe CDAM in detail.

How to Use CDAM

The Compressed Dataset Access Method (CDAM) can be activated on any
DD statement in the job which writes a sequential output file to spool.

Example
The old JCL (without CDAM):

//J01VV JOB ....

//STEP01 EXEC PGM=XXXXXX
//PRINT DD SYSOUT=A

The output (DD statement PRINT) is written to the JES spool.

The new JCL (using CDAM):

//J01VV JOB ....

//STEP01 EXEC PGM=XXXXXX
//PRINT DD SUBSYS=(CDAM,'SYSOUT=A,PREFIX=J01')

The output (DD statement PRINT) is written to a compressed dataset using the
Compressed Dataset Access Method. The high level dataset name qualifier (prefix) is
J01.

Activating the CDAM

Use the following syntax to activate CDAM:

//ddname DD SUBSYS=(subsys-name,'parameters')

Chapter 5 Compressed Dataset Access Method (CDAM) 759

CDAM Parameters

where

ddname is any standard DD name can be used

subsys-name is the name assigned to the Compressed Dataset Access Method at

installation time. The name can be site dependent and is defined by CONTROL-V
installation parameter AMNAME. Throughout this guide the name CDAM is
used.

parameters are CDAM parameters (described below)

The SUBSYS parameter is a standard JCL parameter. For detailed information about
this parameter, refer to the relevant operating system publications.

Compressed Dataset Access Method parameters can span more than one line. In this
case, the following JCL syntax should be used:

//PRINT DD SUBSYS=(CDAM,'PREFIX=J08,UNIT=PROD',
// 'OUTLIM=30000')

CDAM Parameters
Compressed Dataset Access Method parameters are divided into the following
categories:

Sysout control parameters

Access method control parameters

Sysout Control Parameters

JCL syntax rules forbid the use of certain DD subparameters when the SUBSYS
option is used. For example, the following JCL statement results in a JCL syntax error:

//PRINT DD SUBSYS=(CDAM,'XXX'),OUTLIM=100000

To overcome this problem, the user can pass the following sysout control parameters
directly to the CDAM:

760 CONTROL-D and CONTROL-V User Guide

 CDAM Parameters

NOTE
These parameters are CDAM parameters only. They are not JCL parameters.

BURST
CHARS
COPIES
DEST

NOTE
DEST can only contain a node; it cannot contain a user ID.

FCB
FLASH
FORMS
MODIFY
OPTCD
OUTLIM
OUTPUT
SYSOUT
TRC
UCS
PAGEDEF
FORMDEF

The syntax of the parameters is identical to the JCL syntax as described in the relevant
operating system publications. CDAM checks for the correct syntax. For example:

//PRINT DD SUBSYS=(CDAM,'OUTLIM=100000,SYSOUT=(class,extwtr,form)')

The following sysout control parameters do not behave like standard JCL statements:

OUTPUT=name

This parameter designates the name (1 through 8 characters) of a JCL OUTPUT

statement in the Printers Control monitor. It can be specified in the PRINT/CDAM
PARMS field of a report decollating mission usually used for decollating AFP output.
This OUTPUT statement must be defined in the JCL of the Printers Control monitor.

Chapter 5 Compressed Dataset Access Method (CDAM) 761

CDAM Parameters

It usually contains the parameters FORMDEF and PAGEDEF (used for AFP output).
CONTROL-V does not check whether or not the OUTPUT statement exists in the
Printers Control monitor. It is the users responsibility to provide a valid OUTPUT
statement name.

NOTE
AFP (Advanced Function Printing) refers to IBMs laser printing technology. For a full
description of AFP printing considerations see the INCONTROL for z/OS Administrator Guide

PAGEDEF=name

NOTE
The PAGEDEF parameter is ignored when printing on a non-AFP printer.

This parameter designates the name (1 through 6 characters) of a page definition to be

used for printing the output. The page definitions must reside in PAGEDEF libraries
specified to CONTROL-V. For information about specifying libraries, refer to the
CONTROL-D chapter of the INCONTROL for z/OS Installation Guide.

Do not specify the PAGEDEF parameter together with the OUTPUT parameter. If
you do so, the OUTPUT parameter overrides the PAGEDEF parameter.

FORMDEF=name

NOTE
The FORMDEF parameter is ignored when printing on a non-AFP printer.

This parameter designates the name (1 6 characters) of a form definition to be used

for printing the output. The FORMDEF parameter must reside in a FORMDEF
libraries specified to CONTROL-V. For information about specifying the libraries,
refer to the CONTROL-D chapter of the INCONTROL for z/OS Installation Guide.

Do not specify the FORMDEF parameter with the OUTPUT parameter. If you do so,
the OUTPUT parameter overrides the FORMDEF parameter.

COPIES=nn

The sysout control parameter COPIES can be used to specify the number of copies to
print if both the JOB DEFAULTS COPIES parameter and the JOB DEFAULTS MAX
COPIES parameter of the report decollating mission are both set to 99.

762 CONTROL-D and CONTROL-V User Guide

 CDAM Parameters

TRC=

Setting parameter TRC (Table Reference Character) to YES produces the same result
as including the expression OPTCD=J in the JCL.

CDAM Control Parameters

The following parameters are used to control the functions performed by the CDAM:

ACIF DEBUG PREFIX

ALLOCOPT ENCODING PROCSTEP
APA EXIT PS
ASSOC JOBID STEPNUM
BLOB JOBNAME TIME
BLOCKS LAST TRANSTO
CMPEXT LINECT UNIT
CMPRTN PCARCH VOLUMES (for a
maximum of six volumes)
DATE PGMSTEP XMLSEP
DDNAME

ACIF={YES | NO | ONLY | ALL}

The ACIF parameter settings determine the conversion format and destination of the
printing mission, as outlined in Table 276.

Table 276 ACIF Parameter Settings

ACIF Parameter Description
NO Reports are not converted.
Default.
YES Reports with destination CTDPC or reports processed by printing
mission with STORE parameter set to Y are converted to AFPDS
Category 5 format.
ONLY Reports with destination CTDPC or CTDS or reports processed by
printing mission with STORE parameter set to Y are converted to
AFPDS Category 5 format.
ALL All reports are converted to AFPDS Category 5 format.

If the report has ACIF indexes, the original ACIF indexes remain available. However,
identical CONTROL-V indexes are created when the printing mission is processed.
The new CONTROL-V indexes enable the user to access a specific index value
through CONTROL-D/Page On Demand.

Chapter 5 Compressed Dataset Access Method (CDAM) 763

CDAM Parameters

For more information about ACIF and CONTROL-D/Page On Demand, see the
CONTROL-D and CONTROL-V chapter of the INCONTROL for z/OS Administrator
Guide.

For more information about the STORE parameter, see STORE: Mission-specific
Parameter on page 736.

ONEDSN
ALLOCOPT = JOBSDSN1
JOBSDSN2

The ALLOCOPT parameter can be specified in the PRINT/CDAM PARMS field of

any ON statement except ON DSN. If specified elsewhere (during a write operation),
an error message is not produced and the parameter is ignored.

NOTE
For more detailed information about this parameter, see CDAM Logic on page 775.

When CONTROL-D decollates a report from spool, it creates the following entities:

A CDAM file containing the compressed report. A CDAM file is created for every
JES dataset (usually corresponding to every job DD statement).

A report descriptor entry in the Active User Report list ($SYSDATA record). This
record contains general information about the compressed CDAM file and
pointers to the beginning and end of the report.

One or more user or report entries in the Active User Report list. This record
contains the report name and pointers to the beginning and end of the report pages
belonging to the user.

Under classical circumstances, such as a large sysout distributed to many users, the
decollation results are:

One CDAM dataset.

One SYSDATA entry describing the CDAM dataset.

Many user and report entries describing each recipient of (any part of) the report.

However, CONTROL-V is not only used for distributing reports to users. Another
common usage of CONTROL-V is to archive MSGCLASS output from production
jobs. Following is a schematic example of a report decollating mission definition used
for this purpose:

764 CONTROL-D and CONTROL-V User Guide

 CDAM Parameters

ON CLASS A
WHEN - no data in the WHEN statement
DO USER PRODCNTL
DO NAME PRODUCTION MSGCLASS
DO BACKUP BCK0031D

If special CDAM allocation options are not used, the decollation results are:

Many CDAM files (three JES job datasets; one file for each DD statement).

Many SYSDATA entries (one for each CDAM dataset).

One user or report entry describing all the CDAM datasets.

This technique increases the number of records in the CONTROL-V user files,
resulting in inefficient resource usage. It wastes space and slows down CONTROL-V
operation. Space utilization on the disk is not efficient because each small CDAM
dataset occupies one whole track.

The following ALLOCOPT (allocation) options can be used to remedy these

problems:

ALLOCOPT=ONEDSN

When the above decollation is activated with this option, the results are:

One CDAM dataset containing all sysouts of the job (from the decollated class).

One SYSDATA entry for the entire CDAM dataset.

One user or report entry.

Under this option, CONTROL-V assumes that the printing parameters of the first
decollated JES dataset apply to all sysouts in the CDAM dataset. Translation from
machine printing control characters to ASA control characters is accomplished
automatically at printing time.

ALLOCOPT=JOBSDSN1

When the above decollation is activated with this option, the results are:

The sysouts are written to a multi-job CDAM dataset (see below).

One SYSDATA entry for each job, describing all the sysout datasets of this job.

One user or report entry.

Chapter 5 Compressed Dataset Access Method (CDAM) 765

CDAM Parameters

Under this option, CONTROL-V assumes that the printing parameters of the first
decollated JES dataset of the job apply to all sysouts of the job. Translation from
machine printing control characters to ASA control characters and vice versa is
accomplished automatically at printing time.

ALLOCOPT=JOBSDSN2

When the above decollation is activated with this option, the results are:

The sysouts are written to a multi-job CDAM dataset (see below).

One SYSDATA entry for each JES sysout dataset (as in classical decollation).

One user or report entry.

Under this option, the printing parameters of each dataset are kept automatically.

APA=YES or NO

The APA parameter can be set to YES for AFPDS reports or to NO for regular reports.
The default value is YES if the report contains only AFP lines (which begin with
hexadecimal 5A). Otherwise, the default value is NO. The parameter is optional.

For an explanation of how setting the APA parameter to YES affects report indexes,
see ACIF={YES | NO | ONLY | ALL} on page 763.

ASSOC=associationtype

This parameter specifies the report file type (for example, DOC, PDF, AFP).

Reports viewed using CONTROL-D/Page On Demand or CTDWA are viewed

according to the specified ASSOC value. For example, a report with association type
PDF is viewed with Adobe Acrobat.

BLOB=imagetype

The presence of this parameter indicates that the report was created with
CONTROL-D/Image. The value indicated by BLOB is the image type specified when
implementing CONTROL-D/Image (for example, DOC, GIF, JPG).

For more information about CONTROL-D/Image, see the CONTROL-D and

CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

766 CONTROL-D and CONTROL-V User Guide

 CDAM Parameters

BLOCKS=number

This parameter specifies the number of blocks allocated for the first logical extent of
the compressed dataset. The parameter is optional. The default is defined by the
CONTROL-V installation parameter AMBLOCK.

The parameter should be used when the user wants to control the allocation
algorithm of CDAM in order to improve system performance. For a full explanation,
see CDAM Logic on page 775.

For example:

A report contains 100,000 lines. The record length is 121. The total space required
(before compression) is 12,100,000 bytes. Assuming a compression rate of 50%, the
total compressed space required is 6,050,000 bytes. The recommended block size of a
CDAM dataset on a 3380 is 23476. Therefore, 6,050,000 : 23476 = 258 blocks are
needed.

Using the default primary allocation size (assume 200) does cause CDAM to create at
least two datasets (logically connected transparent to the application program). If
the user wants to create only one dataset (for performance reasons), a larger block
number should be specified. For example:

//PRINT DD SUBSYS=(CDAM,'BLOCKS=280')

Whatever block number is used, CDAM does not abend due to space shortage when
the initial allocation space is exhausted. In any case, any unused block in the allocated
dataset is released at the end of the job step. For more details, see CDAM Logic on
page 775.

If the STORE parameter in the Printing Mission Definition screen is set to Y (Yes), a
new report file is created. This file incorporates print resources and can be viewed
through CONTROL-D/Page On Demand. CONTROL-V indexes that were defined in
the decollation mission are converted to fit the new report file. The new CONTROL-V
indexes enable the user to access a specific index value through CONTROL-D/Page
On Demand. For more information about CONTROL-D/Page On Demand, see the
CONTROL-D and CONTROL-V chapter of the INCONTROL for z/OS Administrator
Guide.

CMPEXT=YES

This parameter can be used as a CDAM parameter in PRINT/CDAM PARMS in

decollation mission definition, and as a SUBSYS parameter in JCL.cards.

Chapter 5 Compressed Dataset Access Method (CDAM) 767

CDAM Parameters

When this parameter is used, CONTROL-D saves in the CONTROL-D repository

most of the printing parameters that are used in the OUTPUT card when the sysout is
created in the spool. These parameters can later be used automatically during CONTROL-D
printing. In this case, optional wish WD3133 (Dynamic allocation of OUTPUT card) must be
activated with DATAC=ALL or DATAC=CMPEXT:

ID=WD3133,APPLY=YES,DATA=0,DATAC=ALL

CMPRTN=name

The name of the compression and decompression routine. This parameter overrides
the default compression routine supplied with CONTROL-V. The current default
routine has a compression rate of 30% 70% for reports and dumps.

DATE=jjj

The day in the year in Julian format. This parameter represents the day on which the
compressed sysout was created. This parameter can be used for retrieval purposes. If
a different date is desired when creating a CDAM file, use the DSN field of the
DD statement, which is described in Parameter DSN of the DD Statement on
page 773.

DDNAME=name

This parameter can be used for retrieval. The format is a 1 - 8 characters valid
DD name. This parameter represents the DD name from which the compressed
sysout has been created.

DEBUG{YES|NO}

This parameter helps CONTROL-V support personnel solve problems. The

parameter is optional. The default setting of DEBUG is NO (that is, no special debug
printout). When DEBUG is set to YES, CDAM writes special messages, snaps and
other relevant data to DD statement CDAMSNAP. CDAM expects this DD statement
to be defined in the job step. This DD statement must not use CDAM. The debugging
messages must be directed to the spool or to a regular sequential dataset. For
example:

//PRINT DD SUBSYS=(CDAM,'PREFIX=J01',
// 'DEBUG=YES')
//CDAMSNAP DD SYSOUT=X

768 CONTROL-D and CONTROL-V User Guide

 CDAM Parameters

ENCODING={rprt_enc|NO}

This parameter specifies the character set used in the report. Although the report is
written to CDAM in the original encoding, the decollation mission works with text
translated into EBCDIC code.

If the encoding is not defined for an XML report, the encoding is taken from the XML
header record. If the encoding is not specified in the XML header, the UTF-8 code is
assumed according to the XML standard. If this parameter is not specified for a non-
XML report, no translation is performed.

The list of supported encoding is located in the ENCODTBL member of the IOA
IOAENV library.

Examples

A text report with ENCODING set to ISO-8859 is translated from ASCII to EBCDIC
for the decollation process.

An XML report that has the following tag in the first line, and without the
ENCODING parameter specified, is translated from UTF-8 Unicode to EBCDIC:

<?xml version=1.0 encoding=UTF-8?>

An XML report that has no header tag, and ENCODING is set to NONE, is not
translated.

EXIT{YES|NO}

This parameter designates whether output processing Exit CTDX018 should be

activated. This parameter can only be used when writing directly to a CDAM file. The
default setting of EXIT is NO (that is, the exit is not activated). This default can be
changed by the INCONTROL administrator. When EXIT is set to YES, the exit
receives control for every line which is written to a CDAM file. For additional details,
see CDAM User Exit CTDX018 on page 779.

JOBID=Jnnnnn

This parameter can be used for retrieval purposes. The format is Jnnnnn where nnnnn
is the JES job ID of the job which created the compressed sysout.

JOBNAME=name

This parameter can be used for retrieval purposes. The format is a 1 through 8
character valid jobname. It represents the job which created the compressed sysout.

Chapter 5 Compressed Dataset Access Method (CDAM) 769

CDAM Parameters

LAST{YES|NO}

This parameter is used, along with other parameters, as a retrieval criteria to obtain
the sysouts of the last job. The default value of this parameter is N (No).

If LAST is set to Y (Yes), CONTROL-V retrieves (decollates) the sysouts of the last
execution of the job. For example:

ON DSN PREFIX=CDU08,DDNAME=REPOUT,LAST=YES

For the specific report decollating mission jobname, the last execution of the job
which produced output on DD statement REPOUT is processed and its outputs from
DD statement REPOUT (CDAM datasets) are decollated.

LINECT=number

This parameter can be used for reports without page control characters (machine or
ASA reports). When printing without CONTROL-V, the printer normally skips to a
new page based on the value of the LINECT parameter of the OUTPUT statement.
The same is true for CONTROL-V. It breaks such reports into pages based on the
value of the LINECT parameter. If the parameter is not specified for such reports,
CONTROL-V assumes that the value of LINECT is 100.

This parameter affects all reports. Even if a report has page control characters, a page
break occurs after LINECT lines if control character 1 is not detected.

This parameter should be specified in the CDAM parameters when writing directly to
CDAM or in the PRINT/CDAM PARMS field when decollating from spool. For more
information, read about parameter LINECT in PRINT/CDAM PARMS: Decollating
Parameter on page 586.

PCARCH={Y|N}

Specifies whether the report is (Y) or is not (N) archived (backed up) by
CONTROL-D/WebAccess Server after the report is transferred to a PC. For more
information, see the description of modifying report attributes in the
CONTROL-D/WebAccess Server Administrator Guide.

PGMSTEP=name

This parameter may be used for retrieval. The format is a 1 through 8 character valid
job step name. It represents the step in the job from which the compressed sysout has
been created.

770 CONTROL-D and CONTROL-V User Guide

 CDAM Parameters

PREFIX=name

CDAM writes the sysout to sequential datasets. The PREFIX parameter specifies the
high level datasets name qualifier. The name must be a valid dataset name qualifier of
from 1 through 7 alphanumeric characters. It may consist of two parts separated by a
period, but total length cannot exceed seven characters.

This parameter is optional. If omitted, the following occurs:

If the file is created when writing directly to CDAM, the value specified in the
CONTROL-D installation parameter AMPREF in the CTDPARM member is used.

If the file is created by CONTROL-D decollation with ALLOCOPT=JOBSDSN1, the

value specified in the CONTROL-D installation parameter JB1PREF in the
CTDPARM member is used.

In all other cases (the file is created by CONTROL-D decollation without

ALLOCOPT, or with ALLOCOPT=ONEDSN or JOBSDSN2), the value specified in
the CONTROL-D installation parameter AMPREFD in the CTDPARM member is
used.

The dataset names created by the CDAM are subject to regular security constraints
imposed by the data center (using any standard security package or site-developed
system). The dataset is allocated and opened using the standard system services, thus
enforcing regular security considerations.

PROCSTEP=name

This parameter may be used for retrieval. The format is a 1 through 8 character valid
procedure step name. It represents the JCL procedure step name from which the
compressed sysout has been created.

PS={DOC1|CSET}

The PS parameter can be used to decollate PostScript output using the DOC1 or
CompuSet product.

STEPNUM=nn

This parameter can be used for retrieval. The format is nn where nn is the relative
number of the step from the beginning of the job (in hexadecimal format). It
represents the step number in the job from which the compressed sysout has been
created.

Chapter 5 Compressed Dataset Access Method (CDAM) 771

CDAM Parameters

TIME=hhmm

This parameter can be used for retrieval. The format is hhmm representing the hour
and minute when the compressed sysout was created.

TRANSTO=transformationtype

This parameter specifies the type of file to which the report is transformed when
viewed using CONTROL-D/Page On Demand (for example, PDF, TXT).

For example, if the CDAM parameter APA is set to YES (specifying an AFP report)
and TRANSTO is set to PDF, when the AFP report is viewed using
CONTROL-D/Page On Demand, it is converted to a PDF file.

The file conversion occurs only if the appropriate conversion utility is installed.

For more information about the TRANSTO parameter, see the CONTROL-D and
CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

UNIT=name

The name of the unit on which the compressed sysout is written. The name must be a
valid (1 through 8 character) unit name within the system. The unit must be a disk
and it can span any number of disk drives. The parameter is optional. The default
name is defined by CONTROL-D installation parameter AMUNIT.

VOLUMES=(nnnnn1,...nnnnn6)

The names of the volumes on which the compressed sysout is written. The names
must be a valid volume name within the system. The parameter is optional. The
default name is defined by the CONTROL-D installation parameter AMVOL.

XMLSEP=tagname

Defines an XML tag to be used for splitting an XML document into pages. The value
tagname is case-sensitive. When XMLSEP is set to a value, the ASSOC parameter is set
to XML. For CDAM decollation, the XMLSEP parameter must be specified only in the
SUBSYS parameter of the DD statement creating the document. XMLSEP may be
used only for EBCDIC reports.

CDAM Parameter Examples

Example 1

Some of the DD statements use CDAM; others simply write to the spool.

772 CONTROL-D and CONTROL-V User Guide

 Parameter DSN of the DD Statement

// EXEC PGM=XXXX
//PRINT DD SUBSYS=(CDAM,'SYSOUT=A,PREFIX=J01','OUTLIM=100000')
//OUT DD SUBSYS=(CDAM,'SYSOUT=X')
//SYSPRINT DD SYSOUT=X

Example 2

Keep CICS dumps on compressed datasets.

// EXEC CICS
//SYSUDUMP DD SUBSYS=(CDAM,'SYSOUT=X,PREFIX=CICSDMP,BLOCKS=1000')

Example 3

The following example shows how to use CMPEXT=YES in a SUBSYS parameter to

store parameters that are defined in a JCL OUTPUT card.

//S1OUT OUTPUT ADDRESS=(ADR1,ADR2,ADR),BUILDING=BLD,

// FORMS=ABCDEFGH,PAGEDEF=PGDEF,FORMDEF=FRMDEF
//SYSUT2 DD SUBSYS=CDAM,CMPEXT=YES),OUTPUT=(*.S1OUT)

Parameter DSN of the DD Statement

When a DD statement references a CDAM dataset, the value of the DSN parameter is
not used as the CDAM dataset name. A new dataset name is created by CDAM. This
parameter can be used for passing information to the CDAM. For more information
see the following section, Special Use of Parameter DSN=ODATE.D Option.

Special Use of Parameter DSN=ODATE.D Option

The DSN parameter can be used by CDAM to force the date when writing directly to
a CDAM file. As a default, the date of a CDAM file is taken from the computer clock
(that is, the date of its creation). When the DSN parameter is in the following format,
the CDAM dataset date is taken from the DSN field:

//XXX DD SUBSYS=(CDAM,'....'),DSN=ODATE.Dyyddd

where

yy is the year
ddd is the Julian date

Chapter 5 Compressed Dataset Access Method (CDAM) 773

Parameter DSN of the DD Statement

It may be desirable to force a date in the following situations:

The date can be used as a decollation criteria. When decollating from CDAM
datasets using the ON DSN option, it is possible to specify the date as a parameter.
The resulting decollation includes all sysouts of the job for that date (including
multiple executions on the same day, abends and reruns).

When different business dates run on the same system date, the decollation criteria
may confuse sysouts of different business dates. To prevent this situation, the
business date of the job may be forced as the CDAM dataset date.

The date force option is primarily designed for CONTROL-M users who can
automatically change the CDAM DSN for each business date using the AutoEdit
facility. The special DSN=ODATE option is used to accommodate JCL syntax
limitations. It is impossible to pass a symbolic procedure parameter to subparameters
of a SUBSYS which are between quotes (all CDAM parameters are supplied between
quotes).

Example of the use of parameter DSN=ODATE.D in a CONTROL-M environment:

Sample procedure:

//DEMO PROC DATE=NONE

//STEP01 EXEC PGM=TEST
//DDNAME DD SUBSYS=(CDAM,'PREFIX=CTDSYS'),DSN=ODATE.D&DATE

The job (under CONTROL-M):

//JOBNAME JOB .....

// EXEC DEMO,DATE=%%OYEAR.%%OJULDAY

Users of other scheduling systems can change the date of a CDAM file to the business
date using facilities provided by those products.

The report decollating mission parameters for decollating CDAM datasets created in
all the executions of the job on the same business date should be:

ON DSN PREFIX=CTDSYS,DATE=999

999 is automatically replaced with the original Julian scheduling date of the report
decollating mission.

The report decollating mission parameters for decollating CDAM datasets which are
created in the last execution of the job on the same business date should be:

ON DSN PREFIX=CTDSYS,DATE=999,LAST=YES

774 CONTROL-D and CONTROL-V User Guide

 CDAM Logic

If for some reason, a CDAM dataset is not created for that job on that business date,
reports are not selected. If only LAST=YES is used, reports from the previous
business date are selected.

CDAM Logic
CDAM writes the compressed sysout to a sequential dataset. Each sysout may span
one or more datasets. The datasets are allocated on the unit specified in the CDAM
parameters, without secondary allocation parameters. The workflow of CDAM is as
follows:

When the application program performs the first write (PUT) operation, CDAM
tries to allocate a dataset on the specified (or default) unit using the specified (or
default) blocks parameter and the RLSE option.

The dataset is allocated and opened through standard system facilities, and passes
through all security and allocation verifications performed in the operating
system. In case of failure, normal system messages are produced and the job
terminates.

The dataset name is cataloged immediately at the time of creation. The dataset
name created by CDAM conforms to the naming conventions described below.

When CDAM uses all the available space in the first logical extent, it does not
abend on SB37. It tries to allocate another logical extent (see below for naming
conventions). A logical extent is a standard sequential file from the operating
system point of view. The attempted allocation size is twice the amount of the
previous logical extent size. The logical extent may be on a different disk drive in
the same unit.

If allocation fails (that is, a space in the specified size cannot be found), the CDAM
attempts half of the previous size and continues to do so until the allocation
succeeds. Therefore, CDAM abends on SB37 only when the last single free track in
the specified unit is full, that is, there is no remaining space in the entire unit.

In this way, CDAM makes use of otherwise unusable areas on the disks. The disk
normally contains unused tracks which cannot be used by the standard dataset
allocation algorithm. These areas can be used by CDAM. For example, a CDAM
dataset could be allocated as follows:

NOTE
This example is exaggerated to illustrate the CDAM allocation algorithm

Chapter 5 Compressed Dataset Access Method (CDAM) 775

CDAM Dataset Naming Conventions

Table 277 CDAM Dataset Allocation Example

Logical Extent No. of Tracks
1st logical extent 50 tracks
2nd logical extent 100 tracks
3rd logical extent 50 tracks
4th logical extent 25 tracks
5th logical extent 6 tracks
6th logical extent 1 track
7th logical extent 1 track
8th logical extent 1 track
9th logical extent 1 track

When the ddname of the sysout is deallocated (usually at the end of the step), the
remaining free tracks in the last allocated logical extent are released for general use
(since the dataset is allocated using parameter RLSE).

When a compressed sysout is read by CDAM, the record format, block size and the
record length of the dataset are retrieved. The report takes the original LRECL,
BLKSIZE and RECFM specifications (from the ACB/DCB) as it had when produced
by the application program.

CDAM Dataset Naming Conventions

A CDAM dataset conforms to the following naming conventions:

PREFIX.JOBNAME.JOBID.DATETIME.STEP#.FILEID

Table 278 CDAM Dataset Naming Conventions (part 1 of 2)

Name Description
PREFIX3 Value specified in the PREFIX parameter. If PREFIX is not specified, the
following occurs: The default prefix is taken from the CONTROL-D
CTDPARM installation parameter AMPREFD (unless
ALLOCOPT=JOBSDSN1, in which case the default is taken from
installation parameter JB1PREF). The maximum length is seven
characters.
JOBNAME Name of the job creating the sysout.
JOBID JES number of the job creating the sysout. Format: Jnnnnn.
DATETIME Date and the time when the dataset has been allocated. The format is
Djjjhhmm, where jjj is the Julian day, hh is the hour and mm is the
minute.

776 CONTROL-D and CONTROL-V User Guide

 Multijob CDAM Datasets

Table 278 CDAM Dataset Naming Conventions (part 2 of 2)

Name Description
STEP# Sequence number of the step in the job creating the dataset. The format is
Snn, where nn is the relative sequence number of the step from the
beginning of the job. The number is in hexadecimal notation (01-FF).
FILEID Unique file ID in the format Nnnnnxx, where nnnn represents the
relative position of the file in the allocations performed by the job (in
hexadecimal format), and xx is the logical extent number of the CDAM
dataset (also in hexadecimal format). The first logical extent is 00, the last
one possible is FF.

Multijob CDAM Datasets

A multi-job CDAM dataset differs from a regular CDAM dataset in that it contains
sysouts of many jobs instead of only one job.

The allocation algorithm of a multi-job CDAM dataset allocates a large specified

space for the dataset. All the jobs sysouts are written to the dataset. As soon as a job
is decollated, its sysouts are available for online viewing.

However, unlike regular CDAM allocation options, the file remains allocated to the
CONTROL-D monitor. The monitor adds additional sysouts of jobs to the same file.
When the first logical extent of the CDAM file is full, CDAM allocates a second logical
extent. CDAM continues writing to the logical extent until the end of the processed
job.

Next, the file (which now contains sysouts of many jobs) is deallocated, and the
remaining space in the second extent is freed. When a new job is processed, a new
multi-job CDAM dataset is allocated with the specified space (as first logical extent)
and the process resumes.

This type of CDAM dataset combines the benefits of one large pre-allocated reports
database designated to contain many reports, with the benefits of dynamic allocation
of needed space when the reports database is full.

Multi-job CDAM files, created by using CDAM parameter ALLOCOPT=JOBSDSN1

or ALLOCOPT=JOBSDSN2, cannot be used as input for a report decollating mission.

Chapter 5 Compressed Dataset Access Method (CDAM) 777

Multijob CDAM Datasets

Example of Decollating Parameters

ON CLASS A
PRINTING PARAMETERS ALLOCOPT=JOBSDSN1,BLOCKS=1000,PREFIX=CTDPRDJ
WHEN - no data in the WHEN statement
DO USER PRODCNTL
DO NAME PRODUCTION MSGCLASS
DO BACKUP BCK0031D

It is highly recommended to use parameters BLOCKS and PREFIX in conjunction

with parameter ALLOCOPT=JOBSDSNx. If parameter BLOCKS is not specified, the
default CONTROL-V installation parameter AMBLOCK is used. This parameter
value may be too small, resulting in one JOBSDSN dataset containing a small number
of jobs.

If parameter PREFIX is not specified, the default prefix is taken from the
CONTROL-D installation parameter AMPREFD (unless ALLOCOPT=JOBSDSN1, in
which case the default prefix is taken from the installation parameter JB1PREF).
Using this default prefix may cause regular CDAM datasets and multi-job CDAM
datasets to become intermixed.

NOTE
The prefix used for multi-job CDAM datasets must differ from the prefix used for other
CDAM datasets.

The PREFIX is the unit of integrity of multi-job CDAM datasets. If two (or more)
report decollating missions with ALLOCOPT=JOBSDSNx refer to the same CDAM
prefix, the sysouts are written to the same multi-job CDAM dataset. Different
decollating missions with ALLOCOPT=JOBSDSNx can refer to different prefixes. In
this case, each one is directed to a different multi-job CDAM dataset.

NOTE
Using the same prefix for regular CDAM datasets and multi-job CDAM datasets may affect
the reliability of utility CTDAMUTI. For more information, see Using Utility CTDAMUTI on
Multi-job Datasets on page 784.

When to Use Each ALLOCOPT Option

For regular (large volume) reports, it is recommended not to use the ALLOCOPT
options. The best performance and results are achieved with the classical CDAM
technique.

778 CONTROL-D and CONTROL-V User Guide

 CDAM User Exit CTDX018

ALLOCOPT=JOBSDSN2 should be used for decollating many short sysouts, where

each sysout has different printing characteristics (for example, different CHARS).
Since a SYSDATA entry is developed for each sysout, the printing characteristics are
not lost. An advantage to this option is the efficient use of CDAM space since, many
short reports are compressed into a combined area (without any unused free space).

ALLOCOPT=JOBSDSN1 should be used for decollating many short sysouts, where

each sysout has the same printing characteristics. (If they differ only by the type of
page control characters, machine or ASA, they can be treated similarly.) An example
is generic decollating of job MSGCLASS outputs. Since only one SYSDATA entry is
developed for each job, only a limited amount of space is used in the User Reports
List files. Another important advantage is the efficient use of CDAM space, since
many short reports are compressed to a combined area (without any unused free
space). This method is the most space-efficient and results in faster decollation.

Use ALLOCOPT=ONEDSN under the same conditions as ALLOCOPT=JOBSDSN1

when a separate CDAM dataset is required for each job.

CDAM User Exit CTDX018

CDAM User Exit CTDX018 is activated when the CDAM expression EXIT=YES is
specified. The exit, which should be in a LINKLIST concatenation, receives control for
every line written to the CDAM file.

NOTE
If CTDX018 is not in the LINKLIST, the IOA LOAD would need to be in the steplib
concatenation of every job that writes directly to CDAM.

On first invocation, the exit can specify that CDAM must perform one of the
following functions:

write the file to a CDAM dataset (as normally done)

suppress CDAM processing, leaving the exit responsible for processing the report

Alternatively, on any invocation after the first, the exit can modify the contents (and
optionally the length) of the report line before it is written to the CDAM file. If the
length is set to zero, the line is not written to the CDAM file, which is equivalent to
suppressing the line.

Chapter 5 Compressed Dataset Access Method (CDAM) 779

Example 1. Order a Report Decollating Mission

As a further alternative, the exit can, on the first or any subsequent invocation,
perform one of the following functions:

activate other programs, as described in Example 1

add lines to the report, as described in Example 2

The following examples illustrate these functions.

Example 1. Order a Report Decollating Mission

The exit can order a report decollating mission depending on job name, step name,
DD name, and so on.

This is useful for:

Processing jobs which run several times a day and which write all their reports to
CDAM. In this case, the exit orders a new report decollating mission for each run
of the job.

Processing jobs which produce CDAM files depending on the input which the jobs
receive. In this case, the exit orders a report decollating mission when a CDAM file
is created. When the job does not create a CDAM file, a decollation is not ordered.

The CTDX018O member in the IOA SAMPEXIT library contains a sample exit that
orders a report decollating mission when the CDAM file is created.

Example 2. Add Lines to the Report

The CDAM exit can add lines to the report by suppressing normal CDAM processing
and performing the following:

Inform CDAM (via a return code during the file open) that CDAM should not
process the lines but should pass the lines to the exit.

Use dynamic allocation, in this case, without the EXIT parameter being set to YES,
to allocate a new CDAM file.

Write records to the newly allocated CDAM file. The records can be the original
records written by the application (and passed by CDAM to the exit) and/or they
can be new records.

Using this method, the exit can add any number of lines to the report or easily change
or suppress lines.

780 CONTROL-D and CONTROL-V User Guide

 Example 3. Split a Report by Lines (Decollate by Line)

Example 3. Split a Report by Lines (Decollate by Line)

Many data centers have developed partial solutions to report distribution problems.
One common solution is designation of the recipient as part of the report line (for
example, as initial characters which are later not printed). Usually, this type of report
is processed by CONTROL-V without the use of the exit.

However, if each line of the report is to be distributed to a different user (that is, the
page should be broken down by lines), the use of the CDAM exit is required. The exit
can dynamically allocate a different CDAM dataset for each user, and actually
decollate the report while it is written to CDAM. Member CTDX018S in the IOA
SAMPEXIT library contains a sample exit that splits a report into two different
CDAM datasets.

CDAM Maintenance Utility CTDAMUTI

Utility CTDAMUTI is used to copy, move and delete CDAM datasets. (CTDAUTI is
the program name for utility CTDAMUTI.)

The CDAM dataset is composed of one or more system datasets which are logically
connected. They appear to the application program as one sequential dataset only
when they are interfaced using CDAM (using parameter SUBSYS).

Standard system maintenance utilities are able to function only on one logical extent
(system dataset). To delete an entire CDAM dataset, the user must physically delete
all the logical extents of the dataset. Utility CTDAMUTI enables the user to delete all
extents of a CDAM dataset using regular CDAM parameters.

NOTE
For deleting unneeded CDAM files, also see utility CTDCCU in the INCONTROL for z/OS
Utilities Guide.

Another important use of utility CTDAMUTI is for emergency situations. If for some
reason, the CDAM subsystem cannot be started and it is therefore impossible to read
the CDAM datasets using the normal SUBSYS parameter, this utility can decompress
the sysout to its original (non-compressed) form even if the CDAM subsystem is not
active.

Chapter 5 Compressed Dataset Access Method (CDAM) 781

Activating the Utility

If DD statement UTICOPY is present in the job which activates utility CTDAMUTI,

output is written to the file referenced by this DD statement instead of to the SPOOL.
Utility CTDAMUTI sets the DCB parameters of this output file according to the
original report, that is,

RECFM is set to VB, or VBA, or VBM (according to the original report)

LRECL is set to 32756
BLKSIZE is set to 32760

If DUMMY is specified in the UTICOPY DD statement, the CTDAMUTI utility lists

the CDAM files that fit specified selection criteria.

Activating the Utility

// EXEC CTDAMUTI
//DAMUTIN DD *
PARAMETERS
//

Parameter Format
function
dataset identification parameters (selection criteria)

where function can be:

DELETE Delete one or more CDAM datasets conforming to the identification

parameters.

COPYCopy one or more CDAM datasets conforming to the identification

parameters to a sysout on the spool (decompressed).

MOVEMove (copy and delete) one or more CDAM datasets conforming to the
identification parameters to a sysout on the spool (decompressed).

RECOVERPerform the COPY function (described above) but add a line

containing CDAM characteristics for each processed file. This parameter is useful
when processing multi-job CDAM datasets. See Using Utility CTDAMUTI on
Multi-job Datasets below.

782 CONTROL-D and CONTROL-V User Guide

 Parameter Format

The dataset identification parameters can be any valid CDAM subsystem parameters.
They should be specified between columns 1 - 71 and should be separated by
commas.

When using ALLOCOPT=JOBSDSN1 only the following parameters are used in the
selection criteria:

JOBNAME
JOBID
SYSOUT
DATE

When using ALLOCOPT=JOBSDSN2 only the following parameters are used in the
selection criteria:

JOBNAME
JOBID
SYSOUT
DATE
DDNAME
PGMSTEP

Examples

Example 1

// EXEC CTDAMUTI
//DAMUTIN DD *
DELETE
JOBNAME=J01MUTP,JOBID=J00345,
DATE=298,
PREFIX=J01

All compressed sysouts of the specified job name and job ID for the Julian date 298
starting with prefix J01 are deleted.

Example 2

// EXEC CTDAMUTI
//DAMUTIN DD *
COPY
DATE=298,
PREFIX=J01

Chapter 5 Compressed Dataset Access Method (CDAM) 783

Parameter Format

All compressed sysouts of the Julian date 298 starting with prefix J01 are printed to
spool. A different sysout dataset is created for each original sysout. The original
sysout printing attributes (class, recfm, chars, and so on.) are used for the spooled
sysout.

Example 3

// EXEC CTDAMUTI
//DAMUTIN DD *
RECOVER
PREFIX=JB1,
DATE=298,
ALLOCOPT=JOBSDSN1

All compressed sysouts of the Julian date 298 starting with prefix JB1 are printed to
spool. A different sysout dataset is created for each original sysout. The original
sysout printing attributes (class, recfm, chars, and so on) are used for the spooled
sysout.

At the beginning of every sysout, CONROL-D inserts an additional line containing

CDAM characteristics that are used during decollation. New SYSDATA records will
contain original JOBNAMEs, JOBIDs, and so on. This RECOVER parameter is useful
when processing multi-job CDAM datasets.

Using Utility CTDAMUTI on Multi-job Datasets

When activating utility CTDAMUTI on multi-job CDAM datasets (that is, datasets
created using parameter ALLOCOPT=JOBSDSNx), use the following rules:

Table 279 Rules Used when Activating utility CTDAMUTI on Multi-Job CDAM Datasets
Rule Description
COPY Always add parameter ALLOCOPT=JOBSDSNx to the selection criteria.
Also use the special prefix of the multi-job dataset.

When copying more than one CDAM file to a data set the output file
cannot be a PDS member.
DELETE Do not use this function for multi-job datasets.
MOVE Do not use this function for multi-job datasets.
RECOVER This function can be used for re-decollating reports from multi-job
CDAM files. It provides information for building user and SYSDATA
records with the original JOBNAME, JOBID, DDNAME, PGMSTEP and
other parameter values. This function is primarily useful for JOBSDSNx
files. Therefore, parameter ALLOCOPT=JOBSDSNx should be specified.
It is recommended to rename files to be re-decollated by changing their
prefix so that the new prefix can be specified in the RECOVER function as
a dataset identification parameter.

784 CONTROL-D and CONTROL-V User Guide

 Migrated CDAM Datasets

Because of the above limitations, the same prefix should not be used for regular
CDAM datasets and multi-job datasets.

Migrated CDAM Datasets

The CONTROL-V migration process migrates CDAM datasets to various storage
media (optical disk, cartridge, DASD, and so on). CDAM datasets migrated by a
primary migration mission can be viewed and/or printed using CONTROL-V
online viewing functions. The IOA Archive server is used to access migrated CDAM
datasets for online viewing and immediate printing.

NOTE
The IOA Archive server is not required for viewing or printing CDAM datasets which
migrated to DASD.

IOA Archive Server

The IOA Archive server is a started task that provides services for online viewing and
immediate printing. These services are used whenever data is required from a
migrated CDAM or index dataset which does not reside on DASD.

Communication between the online viewing process and the IOA Archive server is
accomplished using cross memory services.

The IOA Archive server receives data retrieval requests from online viewing users.
Data from various migrated CDAM datasets that reside on different media may be
requested. The server implements request queuing and data caching mechanisms to
optimize available resource utilization and return requested data as quickly as
possible. For more information about the IOA Archive server, see the CONTROL-D
and CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide.

Media and Resource Management

The media and resources available for use by the IOA Archive server are defined by
installation parameters in member IOASPRM. The definition of media and resources
differs for various media types, but includes the following:

Media information (name, type, and so on.)

Chapter 5 Compressed Dataset Access Method (CDAM) 785

OSS Media

Information about each resource (device, session, and so on) known to the server
and the desired status of the resource when the server is started.

An owned or shared flag (dedicated versus dynamic) which indicates if the

resource is dedicated to the server, or is dynamically assigned when needed and
released when no server requests are pending.

NOTE
Non-dedicated resources may degrade response time if insufficient resources are available for
the IOA Archive server when required.

The initial status of resources defined in the installation parameters can be changed
during processing by operator commands.

Resources required for the IOA Archive server should be online and ready when
requested. Services provided by the IOA Archive server degrade or stop if a required
resource is not available. In this case, users requesting online viewing or immediate
printing may be left waiting for data from migrated CDAM datasets.

OSS Media
The DataWare/ROSs/OSS Storage System (OSS) utilizes 3490 emulation. Its
resources are 3490 devices which are referred to by device number. These devices
should be explicitly defined to the IOA Archive server (by device number) and
dedicated to the server.

Devices that temporarily need to be used by other jobs or by started tasks should be
disconnected from the IOA Archive server by an operator command.

The IOA Archive server uses a queuing mechanism to minimize platter switching.

FTK Media
The resources defined for FTK media are the number of sessions the IOA Archive
server has with the FileTek Storage Machine (SM). For each data set that is viewed or
printed from the SM, the FTK media activates a logical device that opens a session
with the SM and retrieves all the necessary data.

The maximum number of logical devices is defined in IOASPRM by parameter

MAXCONN.

786 CONTROL-D and CONTROL-V User Guide

 CART Media

The IOA Archive server uses a queuing mechanism to retrieve together all the data
from the same dataset.

CART Media
The resources defined for CART media are actual 3490 devices. These devices may be
defined explicitly by specifying their device numbers, or implicitly by specifying the
quantity of devices available for the IOA Archive server. It is also possible to define
whether the devices are owned by the server (DEDICATED), or are shared by the
server and other jobs based on need (DYNAMIC).

The IOA Archive server uses a queuing mechanism to minimize volume switching.

Dedicated Device Method

Using this method, the IOA Archive server allocates the devices (which may be
defined explicitly, or implicitly by quantity) during initialization and de-allocates
them when an appropriate operator command is issued. This guarantees the number
of volumes which can be accessed concurrently for online viewing and immediate
printing requests.

Devices that temporarily need to be used by other jobs or by started tasks should be
disconnected from the IOA Archive server by an operator command.

This method is recommended to ensure a rapid response time when many requests
are issued to different volumes.

Dynamic Device Method

Using this method, the server allocates devices (up to the start quantity defined in
the installation parameters) when a request is received. When no requests are
pending, the devices can be used by other jobs or started tasks.

Based on the level of service required and the number of pending requests, the
operator can increase (up to the maximum quantity defined in the installation
parameters) or decrease the number of devices the server tries to use.

This method provides no guarantee that devices are available to the IOA Archive
server when needed. If many requests are pending and not enough devices are
available, response time for users degrades.

This method is recommended when the server is often idle, or when there is a
shortage of 3490 drives.

Chapter 5 Compressed Dataset Access Method (CDAM) 787

CART Media

788 CONTROL-D and CONTROL-V User Guide

 Chapter

6
6 Implementation Hints
This chapter contains the following topics:

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791
Defining the Recipient Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791
Defining the Levels of the Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791
Defining Report Recipients . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 793
Recipient Tree Recommendations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 794
Report Decollating Missions and the Use of the Recipient Tree . . . . . . . . . . . . . 795
Defining the Recipient Tree Operations Control Subtree . . . . . . . . . . . . . . . . . . . 802
Recipient Tree and Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803
Decollation Without the Recipient Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 803
Decollating Criteria Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805
Report Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805
Decollation of Report Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 807
Decollation of XML Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 817
Indexing Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 820
Report Design. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 820
Index Design. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 821
Migrated vs. DASD-resident Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822
Naming Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822
Index Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 824
Using Indexes for Retrieval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825
Testing Indexes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 825
Printing Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 826
Printing Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 826
Using OUTPARM for Global Control of Printing Characteristics . . . . . . . . . . . . 830
Controlling the Printing Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 830
Workload Considerations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831
Weekend Distribution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831
Report Decollating Missions and Printing Missions The Link . . . . . . . . . . . . . 831
Specifying Report Destination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 832
Sending Entire User Bundle to a Specific Destination . . . . . . . . . . . . . . . . . . . . . . 832
Sending Specific Reports to Specific Destinations . . . . . . . . . . . . . . . . . . . . . . . . . 832
Sending Reports to the Original Destination from Spool . . . . . . . . . . . . . . . . . . . 833
Sending Reports to a Specific Destination . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833
Sending Reports to a Specific External Writer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833

Chapter 6 Implementation Hints 789

 Sending Unidentified Pages to a Specific Destination . . . . . . . . . . . . . . . . . . . . . . 833
Destination CONTROL-V Search Order . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 833

790 CONTROL-D and CONTROL-V User Guide

 Overview

Overview
This chapter of the guide is designed for those who are already familiar with the basic
concepts of CONTROL-V, who have read Chapter 1, Introduction and Chapter 2,
Online Facilities, and who have gained some experience with indexing, decollating,
migrating, viewing and using the CONTROL-V Online facility.

The purpose of this chapter is to provide some guidelines for implementing

CONTROL-V at your site. For demonstration purposes, a simplified model of a bank
is used throughout this chapter.

Defining the Recipient Tree

The Recipient Tree is a list of all possible report recipients, arranged according to the
organizations hierarchy. A properly designed Recipient Tree can speed up the
process of implementing CONTROL-V. However, the Recipient Tree can be modified
at any time and the initial tree definition can be modified and developed as
experience is gained using various product options.

The Recipient Tree definition is built in two stages:

Defining the levels of the organization.

Inserting recipient information in the tree.

Defining the Levels of the Organization

The levels of the organization (that is, the structure of the tree) are defined in the
CONTROL-D installation parameters in the IOA PARM library. Each level of the
organization is represented by a two-digit code and a descriptive name. For example:

'30' 'DIVISION'

The levels must be in ascending sort order (for example, 10, 20, 30). The descriptive
name is in free format. The bank example is used below to demonstrate the different
considerations in defining the levels.

The bank is divided into two major groups: the branches and the head office
divisions. The tree is constructed to represent the bank structure:

Chapter 6 Implementation Hints 791

Defining the Levels of the Organization

OPERATIONS
|
PRESIDENT
|
---------------------------------
| |
REGIONAL MGMT DIVISION
| |
BRANCH DEPARTMENT
| |
BRANCH-DEPT SECTION
| |
BRANCH-WORKER WORKERS

Now lets assign levels to the bank structure:

10 OPERATIONS
|
15 PRESIDENT
--------------------------------
| |
20 REGIONAL MGMT 50 DIVISION
| |
25 BRANCH 55 DEPARTMENT
| |
30 BRANCH-DEPT 60 SECTION
| |
--------------------------------
|
70 WORKERS

Notice that the workers level used is the same for the branches and the head office
divisions. A single worker can be directly under any of the levels in the organization
(for example, under a branch, a branch department, a section).

The definition of the tree can be modified any time. New levels can be added without
affecting CONTROL-V operation. Changing the level code, however, may be more
complex; this requires a global change in the current definition of the Recipient Tree
and the report decollating missions. Therefore, it is highly recommended to maintain
an interval between successive levels so that there is a place to insert additional levels
in the future.

The levels of the tree are defined in CONTROL-D installation parameters in the IOA
PARM library. The member must be assembled and linked each time it is modified,
and then copied to a Linklist library (see the INCONTROL for z/OS Installation Guide).

792 CONTROL-D and CONTROL-V User Guide

 Defining Report Recipients

When a change is made to the level definition (for example, a new level is defined),
the CONTROL-V monitor must be shut down and brought up again. It is also
recommended that users of the Online facility log off and log on again. This is only
necessary when the tree structure is modified (not when a new user is defined in an
existing level).

Defining Report Recipients

After the levels of the Recipient Tree have been defined, you can fill the tree with data
(that is, the report recipients names) using the Online facility (option T). For a full
description of how to define report recipients using the Online facility, see Chapter 2,
Online Facilities. The purpose of this chapter is to present some guidelines for
defining the contents of the Recipient Tree, and to demonstrate its use by the various
components of CONTROL-V.

The following information can be defined for each recipient:

NOTE
Parameters marked with the symbol M can have many occurrences.

Required fields

Table 280 Required Fields for Defining Recipients

Field Description
RECIPIENT Name of the user-recipient (1 through 8 characters) must be
unique.
RECIPIENT LEVEL Level of the recipient.
PARENT Name of the recipients parent.
PARENT LEVEL Level of the recipients parent.

Optional fields

Table 281 Optional Fields for Defining Recipients

Field Description
M
DESC Description of the recipient.
M
SYNONYM Another name for the recipient. Each synonym can have a
maximum of 20 characters. Synonyms may be non-unique and
may contain embedded spaces. Any number of synonyms can be
defined.

Chapter 6 Implementation Hints 793

Recipient Tree Recommendations

Implementation hints for the above fields are discussed immediately following this
list of tree definition fields:

Table 282 Tree Definition Fields

Field Description
M
AUTHORIZE Name (or prefix) of users authorized to view or receive the
reports of the recipient.
$SYSDATAM Specifies whether or not the authorized user is also authorized to
see $SYSDATA entries. (For more information see $SYSDATA
Records on page 279.)
ADDRESSM Location where the report is sent after it is printed. Address can
have a maximum of 10 lines and can be printed in the user
banner.
INDEX Specifies whether or not a report index should be printed at the
beginning of the user bundle.
USER BANNER Specifies whether or not to print a user banner at the head of the
users bundle.
REPORT BANNER Specifies whether or not to print a report banner at the head of
each report in the bundle.
DEF DEST Default destination of printed reports for the recipient. For
additional information regarding parameter DEST, see JOB
DEFAULTS DEST: Decollating Parameter on page 536. For
implementation hints, see Specifying Report Destination on
page 832.
PC Parameters Specifies information related to downloading reports to
CONTROL-D/WebAccess Server.

Recipient Tree Recommendations

Lets start from the top the user or recipient name. Only one user should be defined
at the highest level of the recipient tree. This is usually an operations user who is (by
default) authorized to see all reports.

In our example, the branches are organized in groups under regional management.
Each branch is composed of a few functional departments (for example, foreign
currency, stock exchange, loans, and so on). A functional department is usually
composed of one or very few bank workers. Therefore, in many cases, a department
is the final destination of the report. The division of the reports between two workers
in the loans department of a bank branch is done manually by the workers
themselves. However, in the main branch, each department is quite large, and there
are functional differences which justify putting specific workers as the designated
report recipients in the tree.

794 CONTROL-D and CONTROL-V User Guide

 Report Decollating Missions and the Use of the Recipient Tree

Concerning naming conventions, branches are usually assigned a number. You can
decide that the name of the branch is the number itself (for example, 129). However,
this can lead to ambiguity problems, for example, if there is also a section 129. Each
user name must be unique; therefore, confusion can be caused by a report decollating
statement such as:

DO USER 129

It is recommended that all the branches start with a fixed prefix (for example, BR129,
BR130, BR135, and so on). This enables easy and unique identification of the user in
all the screens and reports.

Lets now review the use of the Recipient Tree by report decollating missions.

Report Decollating Missions and the Use of the Recipient Tree

Report decollating missions are instructions on how to process the reports of a
specific job. It is assumed that the reader of this section has a basic familiarity with the
format of the Report Decollating Mission screen. Below are a few examples of various
report decollation problems.

Examples

Example 1

Assume all the branches have been defined under the relevant regional
managements. The following example describes how the decollating instructions are
defined. Consider a report which contains the following string beginning in line 2
column 120:

BRANCH nnn (where nnn is the branch number)

One way of defining the decollation criteria for such a report is:

Chapter 6 Implementation Hints 795

Report Decollating Missions and the Use of the Recipient Tree

Figure 450 Defining Decollation Criteria and Use of the Recipient Tree
Example 1
WHEN LINE 00002 - 00002 COL 00120 - 00129 PRINT REF NXT CT AND/OR
STRING BRANCH 129
DO USER = BR129 LVL LINE COL - S A T
SYNONYM = CONCAT =
DO
WHEN LINE 00002 - 00002 COL 00120 - 00129 PRINT REF NXT CT AND/OR
STRING BRANCH 130
DO USER = BR130 LVL LINE COL - S A T
SYNONYM = CONCAT =
DO
WHEN LINE 00002 - 00002 COL 00120 - 00129 PRINT REF NXT CT AND/OR
STRING BRANCH 131
DO USER = BR131 LVL LINE COL - S A T
.
.
.

This method requires a lot of work. A similar definition must be used for every report
which is distributed to the branches. When a new branch is added, it must be added
to all the report definitions. This method of defining report decollating parameters is
used by most report distribution systems.

The Recipient Tree provides a better solution for this problem. It is possible to define
a synonym for each branch that contains the branch number. For example:

A synonym is added to the user definition in the tree:

25 BR129 The north county branch

SYNONYM 129

The report decollating criteria are defined as:

WHEN LINE 00002 - 00002 COL 00120 - 00125 PRINT REF NXT CT AND/OR
STRING BRANCH
DO USER = * LVL 25 LINE COL 127 - 129 S T
SYNONYM = CONCAT =

The effect of this definition is as follows:

If the string BRANCH is found in the second line of the page between columns 120
125, then take the branch (level 25) name from columns 127 129 of the report.

By using one simple definition, you can define the distribution criteria of this
report for all the branches. If a new branch is added in the future, there is no
change to the report decollation criteria (in any of the jobs). The only requirement
is to add the new branch to the Recipient Tree.

796 CONTROL-D and CONTROL-V User Guide

 Report Decollating Missions and the Use of the Recipient Tree

Example 2

Our sample bank has old reports which do not contain the branch number, but rather
the old branch name (in text format). To solve this problem, only a small
manipulation of the Recipient Tree is required. For each branch, define an additional
synonym containing the name of the branch in text format. The synonym can have a
maximum of 20 characters and can contain blanks.

For example:

25 BR129 The north county branch

SYNONYM 129
SYNONYM North County

As you can see, using the Recipient Tree and the decollating criteria is quite simple
and the parameters can easily be updated and maintained.

The Recipient Tree provides a default security feature. Because the users are
organized in a tree, the regional manager is allowed (by default) to view all the
reports of the branches in their region. This may be very helpful for daily operations.
For example, the regional manager can review the status of a certain account (in the
branchs report) without printing a single copy of the report.

Example 3

Each morning the bank branch receives bags full of mail and reports. Someone at the
branch has to sort them according to the branch department which handles them (for
example, loans, foreign currency, savings). This process takes time and security leaks
can occur when certain data should remain confidential between departments.
Because CONTROL-V allows the bank workers to view reports online, the potential
for a security leak can be a real factor to consider. It would be much better if the
package of reports arriving to the branch each day could be sorted according to the
different departments in the branch, with each worker only being able to view that
department's reports. This can be done using CONTROL-V.

Primitive Method

Define the branch departments as users in the tree and specify a WHEN statement for
each department. Example of the tree:

Figure 451 Defining Decollation Criteria and Use of the Recipient Tree
Primitive Method Example 3
25 BR129 The north county branch
SYNONYM 129
SYNONYM North County
30 BR129LO The Loans department
30 BR129FC The Foreign Currency department
30 BR129SA The Savings department

Chapter 6 Implementation Hints 797

Report Decollating Missions and the Use of the Recipient Tree

Example of WHEN statement specifications:

WHEN LINE 00002 - 00002 COL 00120 - 00129 PRINT REF NXT CT AND/OR
STRING BRANCH 129
DO USER = BR129LO LVL LINE COL - S A T
SYNONYM = CONCAT =
DO
WHEN LINE 00002 - 00002 COL 00120 - 00129 PRINT REF NXT CT AND/OR
STRING BRANCH 130
DO USER = BR129LO LVL LINE COL - S A T
SYNONYM = CONCAT =
DO
WHEN LINE 00002 - 00002 COL 00120 - 00129 PRINT REF NXT CT AND/OR
STRING BRANCH 131
DO USER = BR130LO LVL LINE COL - S A T

As you can see, we now have the same problem discussed in Example 1. We have to
define a specific definition for each branch department. This problem can be avoided
if the Recipient Tree is used to do the job.

Better Method

Define a synonym for each branch department:

Figure 452 Defining Decollation Criteria and Use of the Recipient Tree
Better Method Example 3
25 BR129 The north county branch
SYNONYM 129
SYNONYM North County
30 BR129LO The Loans department
SYNONYM BR-LOANS
30 BR129FC The Foreign Currency department
SYNONYM BR-FOREIGN-CURRENCY
30 BR129SA The Saving department
SYNONYM BR-SAVINGS

The same synonyms are then defined for all the branch departments in the bank. For
example:

25 BR129
30 BR129SA The Savings department
SYNONYM BR-SAVINGS
25 BR130
30 BR130SA The Savings department
SYNONYM BR-SAVINGS
25 BR131
30 BR131SA The Savings department
SYNONYM BR-SAVINGS

Example of decollation criteria:

798 CONTROL-D and CONTROL-V User Guide

 Report Decollating Missions and the Use of the Recipient Tree

WHEN LINE 00001 - 00001 COL 00020 - 00100 PRINT REF NXT CT AND/OR
STRING = NEW SAVINGS ACCOUNTS FOR
DO
WHEN LINE 00002 - 00002 COL 00120 - 00125 PRINT REF NXT CT AND/OR
STRING = BRANCH
DO USER = * LVL 25 LINE 002 COL 127 - 129 S T
SYNONYM = CONCAT =
DO USER = BR-SAVINGS LVL 30 LINE COL - S A T
SYNONYM = CONCAT =
DO NAME = NEW-SAVINGS_ACC LINE COL -

The report is identified by two WHEN statements with an AND relation between
them. The branch (level 25) name is taken from the contents of the report. A user
named BR-SAVINGS should also get the report. A search is carried out under the
branch in the tree for a recipient whose name (or synonym) is BR-SAVINGS. If such a
user is located under the branch, then that user receives the report. Using this simple
approach, the reports can be decollated and packaged according to the branch
departments.

NOTE
In the previous example, it is essential that all the branches contain the synonym. Otherwise,
when CONTROL-V does not find user BR-SAVINGS under a branch, it looks for it under that
branchs siblings in the Recipient Tree (that is, under other branches that perhaps should not
receive the report). See Example 4.

Example 4

As illustrated in Example 3, one does not need to type many instructions in order to
specify complex decollation criteria. However, if that method is used as described, it
requires very careful maintenance of the Recipient Tree. An error in the Recipient
Tree could result in a distribution error. It is possible to overcome this problem by
using the *FORCE option.

If the DO USER statement starts with the string *FORCE followed by a user name or
*, it means some special processing should be performed by CONTROL-V. It forces
the user or level specified in the statement. It prevents CONTROL-V from searching
the recipient tree above the user defined in the *FORCE statement. The decollation
criteria specified in Example 3 should be:

Figure 453 Defining Decollation Criteria Example 4

WHEN LINE 00001 - 00001 COL 00020 - 00100 PRINT REF NXT CT AND/OR
STRING = NEW SAVINGS ACCOUNTS FOR
DO
WHEN LINE 00002 - 00002 COL 00120 - 00125 PRINT REF NXT CT AND/OR
STRING = BRANCH
DO USER = *FORCE-* LVL 25 LINE 002 COL 127 - 129 S T
SYNONYM = CONCAT =
DO USER = BR-SAVINGS LVL 30 LINE COL - S A T
SYNONYM = CONCAT =
DO NAME = NEW-SAVINGS_ACC LINE COL -

Chapter 6 Implementation Hints 799

Report Decollating Missions and the Use of the Recipient Tree

If CONTROL-V finds a branch (level 25) without a BR-SAVINGS department under it

(level 30), the search of the tree is forced to stop at the branch (level 25). The report
page is distributed to the branch itself.

The use of the *FORCE option is highly recommended when the identification of the
user is performed by a combination of more than one USER statement. Notice the use
of the *FORCE option in Example 5.

Example 5 Use of User Exit CTDX016

Assume the following (partial) distribution list:

Figure 454 Use of User Exit CTDX016 Example 5

CORP CENTER NUMBERSUSER

835 1060GUST
835 1200-1281GUST
835 1400-1450GUST
835 1360-1399RIJNVIS
835 2100-2120HAMVD
835 2190-2199HAMVD
835 2300-2379HAMVD
835 8600-8620HAMVD

The above specifies that all reports for corporation 835 with center numbers 1200
through 1281 should go to user GUST, while all reports for corporation 835 with
center numbers 8600 through 8620 should go to user HAMVD. Although it is possible
to build a user tree with thousands of synonym entries, it is not recommended (and
not convenient).

An alternative solution is illustrated in the following sample tree:

Figure 455 Use of User Exit CTDX016, Alternate Solution Example 5

30 835BROER This is the definition for corporation 835
SYNONYM BROER
SYNONYM 835
40 835GUST
SYNONYM GUST
SYNONYM 1060
SYNONYM 1200 TO 1281
SYNONYM 1400 TO 1450
40 835RIJNV
SYNONYM RIJNVIS
SYNONYM 1360 TO 1399
40 835HAMVD
SYNONYM HAMVD
SYNONYM 2100 TO 2120
SYNONYM 2190 TO 2199
SYNONYM 2300 TO 2379
SYNONYM 8600 TO 8620

800 CONTROL-D and CONTROL-V User Guide

 Report Decollating Missions and the Use of the Recipient Tree

Assume the following sample report decollating mission:

WHEN LINE - COL - PRINT REF NXT CT AND/OR

STRING =
DO USER = *FORCE-* LVL 30 LINE 007 COL 001 - 003 S T
SYNONYM = CONCAT =
DO USER = * LVL 40 LINE 012 COL 001 - 004 S T
SYNONYM = CONCAT =
DO LINE COL -

Under normal user and synonym search rules, if line 12 position 1-4 contains the
string 8611 (for example), the user name is not located in the tree and the page is
directed to the default user.

However, you can use CONTROL-V Exit CTDX016 to overcome this problem. The
exit is activated when a string from the report is compared with a recipient name or
synonym in the tree. The exit can check that 8611 is between 8600 and 8620 and OK
the user identification for HAMVD.

Notice the use of the *FORCE option for level 30. If for some reason, a center number
is not located under the corporation in the tree (for example, because somebody
forgot to update the tree with a newly opened center), then the report is distributed to
the corporation. The tree is not searched for a center with the same number under
another corporation.

Example 6

A certain page in the report has to be sent to all the branches (that is, many copies of
the same page are needed). This requirement is common to many reports. What is the
best way to solve the problem?

Primitive Method

Report decollating parameters:

Figure 456 Defining Decollation Criteria and Use of the Recipient Tree
Primitive Method Example 6
WHEN LINE 00001 - 00001 COL 00020 - 00100 PRINT REF NXT CT AND/OR
STRING = FOREIGN CURRENCY RATES
DO NAME = FC-RATES LINE COL -
DO USER = BR129FC LVL 30 LINE COL - S A T
SYNONYM = CONCAT =
DO USER = BR130FC LVL 30 LINE COL - S A T
SYNONYM = CONCAT =
DO USER = BR131FC LVL 30 LINE COL - S A T
SYNONYM = CONCAT =

This presents the same problem again. It requires that you repeat all the user names
for all the report pages that have to be distributed to a large number of users.

Chapter 6 Implementation Hints 801

Defining the Recipient Tree Operations Control Subtree

Better Method

It is possible to define a generic user name (such as BRANCHES). This name defines
decollation criteria for a large number of users (in our case all the foreign currency
branch departments in the bank). For example:

Figure 457 Defining Decollation Criteria and Use of the Recipient Tree
Better Method Example 6
WHEN LINE 00001 - 00001 COL 00020 - 00100 PRINT REF NXT CT AND/OR
STRING = FOREIGN CURRENCY RATES
DO USER = *BRANCHES LINE COL -

For more details about defining generic user name lists, see the CONTROL-D and
CONTROL-V chapter of the INCONTROL for z/OS Administrator Guide, and see
Generic User Name on page 516.

Defining the Recipient Tree Operations Control Subtree

Since the Recipient Tree is one of the most important operations control tools, it is
recommended to create within the tree a subtree for special report processing control
purposes. For example:

10 (operations) OP-MNGR
90 (CD-control) CD-MNGR
95 (op-user) NULL
95 PRODCNTL
95 UNIDENT

The user NULL serves as a destination for reports that should be identified but are
never printed. This user should never be included in a printing mission.

User PRODCNTL receives all the JCL/SYSPRINT (MSGCLASS) messages of the jobs
so they can be reviewed online.

The user UNIDENT receives every unidentified page in the reports.

Additional special purpose users can be defined to solve specific problems at your
site.

802 CONTROL-D and CONTROL-V User Guide

 Recipient Tree and Security

Recipient Tree and Security

The Recipient Tree can be used as a security mechanism for filtering the reports listed
in User Report lists (screen U). When an online user enters a User Report list, only
those reports which the user is authorized to access, as defined in the Recipient Tree,
are listed.

Online users (for example, TSO, CICS, VTAM and IMS users) can be authorized to
access the reports of a recipient by specifying their ID or prefix in the AUTHORIZE
field of the Recipient Definition screen. This AUTHORIZE field is used by security
module CTDSE04 and user Exit CTDX004 to filter the list of reports. For more
information about the AUTHORIZE field of the Recipient Definition screen, see
Recipient Definition Screen on page 176. For more information about user Exit
CTDX004, see the Exits chapter in the INCONTROL for z/OS Administrator Guide.

Decollation Without the Recipient Tree

If the number of potential recipients is very high or the names of the recipients
change frequently, it may be desirable to not define all recipients in the Recipient Tree
because:

Defining and maintaining recipients in the tree can become a time-consuming task.

The time required to load and search a very large tree can degrade the
performance of some CONTROL-V components.

By default, report pages of users who are not found in the Recipient Tree are sent to a
default recipient. This default is not appropriate if user names are intentionally not
defined in the Recipient Tree. Therefore, alternative methods are required which:

Decollate report pages to an extracted recipient name even if the name is not in the
tree. A method to do this is described in 1.

Enable report pages to be viewed by an online user even if the user is not defined
in the tree. Methods to do this are described in 2.

NOTE
Certain recipients must not be omitted from the Recipient Tree. Recipients whose entries
include special information (for example, recipient's address, synonyms,
CONTROL-D/WebAccess Server authorization, $SYSDATA access, special default
destination) must be defined in the Recipient Tree.

Chapter 6 Implementation Hints 803

Decollation Without the Recipient Tree

To enable report decollation and viewing without defining all users in the Recipient
Tree, follow these instructions:

1 In the report decollation mission definition, specify the value A in the T (type code)
parameter of the DO USER statement. When the T parameter is set to A, a recipient
name is accepted even if it is not in the Recipient Tree. For more information about
the T parameter, see DO USER: Decollating Parameter on page 513.

2 Provide a mechanism which enables online users who are not defined in the
Recipient Tree to access reports they are authorized to access. The most efficient
mechanism depends on whether meaningful pseudo-recipients can be defined,
which security products are used at the site, and whether or not information about
recipients is maintained in other files or databases. The following items describe
such mechanisms:

A Specify pseudo-recipients in the tree that represent groups of actual recipients

(that is, a small number of pseudo-recipients can receive reports on behalf of a
large number of undefined actual recipients).

This mechanism can be used when each pseudo-recipient name can be a

prefix formed by the first characters of the names of actual recipients
followed by an asterisk (*). The AUTHORIZE fields for each pseudo-recipient
should contain the name, prefix or mask of online users authorized to access
reports of the actual recipients.

For example: If the Recipient Tree contains an entry with a RECIPIENT field
set to CLERK*, an AUTHORIZE field set to X123, and a second AUTHORIZE
field set to Y??5???, then reports belonging to all recipients whose names start
with CLERK can be accessed by users X123, YAA5, YZZ5123, and others
whose names match the mask Y??5???.

B Use your sites security product (RACF, Top Secret, CA-ACF2/SAF) to

determine which reports can be displayed in the user report list for the current
online user. This mechanism is especially useful when the reports for all online
users can be allocated to a relatively small number of report access categories
and/or the names of the users cannot be properly grouped by a user ID prefix.

Specify the required information by authorizing online users to access entity

$$REPLST.qname.recname

where recname is the name of a recipient whose reports are available to the
appropriate users. Set the DUSERLST parameter to NO and the DREPLST
parameter to YES in the CTDSECP member in the SECSRC library. Then,
recompile the CTDSE04 security module using the appropriate job
(CTDSRAC1, CTDSACF1, and so on).

804 CONTROL-D and CONTROL-V User Guide

 Decollating Criteria Considerations

This method does not check the AUTHORIZE field. However, it may cause
significant overhead in the User Reports List screen (Screen U) because all
recipients whose reports appear in CONTROL-D Active or Permanent or
History User List files are checked via the security product. Performance can
be improved by implementing method C in addition to or instead of method
B.

C Use function USERLIST of User Exit CTDX004 to create a list of recipients

available for each online user. This mechanism is especially useful when up-to-
date user ID information is maintained in other files or databases at the site.

Sample Exit CTDX004U in the SAMPEXIT library shows how to build such a
list of recipients. Exit CTDX004U creates a list by checking the AUTHORIZE
field in the Recipient Tree and adding the name of the current online user to
the list. This exit can be modified for extracting a list of recipients from a site
database or for building the list based on various rules.

The list of recipients can contain prefixes (such as XX*), but usage of short
prefixes can cause significant overhead since they are expanded by scanning
the User Report List files. Sample Exit CTDX004U is useful for implementing
simple rules such as each online user can access the reports of the recipient
with the same name.

Decollating Criteria Considerations

This section discusses decollating criteria considerations for different report sources
and report types.

Report Sources
CONTROL-V can decollate reports from the following sources:

spool (held and non-held)

compressed datasets

Decollating from the Spool

Decollation from the spool has the following characteristics:

Decollation is only carried out on classes specified in the job decollation criteria
(that is, not necessarily all outputs of the job).

Chapter 6 Implementation Hints 805

Report Sources

Sysouts are always copied to CONTROL-V compressed datasets using the CDAM.

If the sysout is in a non-held output class, it is deleted (purged) from the spool.

If the sysout is in a held output class, it remains on the spool.

CONTROL-V retrieves the printing characteristics from the spool and

automatically maintains this information (for future printing).

For JES3, CONTROL-V retrieves regular printing characteristics (for example,

FORM) but not laser printing characteristics (for example, MODIFY, BURST). If
you want to keep the original laser printing characteristics for sysouts decollated
from the spool, you have to specify them in the job decollation parameters (in the
PRINT/CDAM PARMS field).

Decollating from Compressed Datasets

Decollation from compressed datasets that have been created directly from a job
(using parameter SUBSYS) has the following characteristics:

Decollation is only carried out on the compressed datasets specified in the job
decollation criteria (that is, not necessarily all outputs of the job).

It is possible to select reports for decollation by step name and DD name of the job.

CONTROL-V maintains all the printing characteristics (including laser) that were
specified in the DD statement that created the sysout. Therefore, there is no need to
specify any data in the PRINT/CDAM PARMS field.

Sometimes it is necessary to test the decollation criteria of a large report that cannot
be easily produced for testing. There is a simple technique that allows both
decollation by CONTROL-V and normal printing by operators, without having to
rerun the job that produces the report.

The JCL OUTPUT statement allows you to route a sysout to more than one
destination by defining one copy for LOCAL printing and another for DEST Uxxxx or
one copy to the regular output printing class and the other to a held output class.
(Refer to your JCL manual for further details.) The report is deleted from the spool
after CONTROL-V has decollated it, and the printer has printed it. For example:

806 CONTROL-D and CONTROL-V User Guide

 Decollation of Report Types

Figure 458 JCL Output Example

//JOBCARD
//OUT1 OUTPUT DEST=LOCAL
//OUT2 OUTPUT DEST=U1001
.
.
.
//SYSPRINT DD SYSOUT=A,OUTPUT=(*.OUT1,*.OUT2)
.
.
.

Decollation of Report Types

CONTROL-V can decollate the following report types:

text reports
binary reports
print stream reports with transformation

Text Reports
CONTROL-V performs the following decollation functions for EBCDIC text reports:

sets the ownership on reports or parts of reports

sets the lifecycle and storage of reports
distributes reports or parts of reports (printing)
splits reports for different recipients
provides end-user viewing, including quick access through indexes

Binary Reports
CONTROL-V performs the following decollation functions for binary reports:

decollates binary reports to one user, with one name (indexing and splitting are
not available)
sets the binary report and extension according to the CDAM ASSOC parameter
(for example, ASSOC is set to DOC for Word documents)
allows for end-user viewing using CONTROL-D/WebAccess using the
appropriate application (for example, DOC files are read with Word, and PDF files
are read with Adobe Acrobat)

Chapter 6 Implementation Hints 807

Decollation of Report Types

Print Stream Reports Using Transformation

When print stream reports are decollated using transformation, CONTROL-V can
perform the same decollation functions for print stream reports that it does for text
reports.

Transformation is the process used in decollation to extract the text from print stream
reports (as illustrated in Figure 459) as it appears in print reports (as illustrated in
Figure 460).

Figure 459 Print Stream Displayed in Raw Format

Figure 460 Print Stream Displayed in Print Format

808 CONTROL-D and CONTROL-V User Guide

 Decollation of Report Types

As Figure 459 illustrates, it is not simple nor practical to locate the text directly from a
raw formatted print stream report. To accommodate this, the transformation process
performs the following three actions on a print stream report:

Creates a text version of the pageThis page includes all the data for the current
page of the report in text format. The decollation definition uses this page to locate
specific text on the current page of the report.

Creates a Normalized pageThis page includes all references to resources for the
current page. The Normalized page allows you to view a single page of a report, or
part of the report, without having to view the entire report. Print stream report
pages may use resources from previous pages of the report to display the page,
while the Normalized page references all resources for each individual page.

Specifically, the Normalization process does the following

for AFP reports:

Normalized AFP reports have additional 2 NOP (comment) records for each
page. These records include the IMM that is active for the page, and indicate
whether the page is a front page or back page for duplex reports.

All Group information and TLE records are removed from the Normalized
report.

for Xerox reports:

Normalized Xerox reports are always Metacode, with DJDE lines in EBCDIC for
each page.

All reports use the same JSL (PROMETA) and the same JDE. During the creation
of the Normalized report STARTON is used, and for viewing the Normalized
report NMOJOB is used.

If the original report was an LCDS report, after Normalization it becomes a

Metacode report.

Provides Resource ManagementDuring the transformation process, all of the

resources used for decollating the report are stored by the CONTROL-D Resource
Manager. This manager maintains the resources for each report in a resource
library and in the Permanent User File, including the following information about
the resource:

format (AFP or Xerox)

name
type (font, logo, and so on)
unique checksum

Chapter 6 Implementation Hints 809

Decollation of Report Types

This information enables you to view a report using the same resources that the
report used during decollation.

If a report resource changes, a new version of that resource is stored in the resource
library. After the changed resource is stored, all subsequent versions of the report
use the new version of the resource when you view the report. Earlier versions of
the report continue to use the previous resource as defined for them. This enables
you to view or print a report with its own original resource, even after the original
resource is no longer in use.

During the report decollation process, a special Resource Set record associated
with the report is created in the Permanent User File, whose key is stored in an
associated SYSDATA record. The Resource Set record references all resources used
by the decollated report. Duplicate Resource Set records are not created, so that the
SYSDATA record points to the existing Resource Set record if the current
decollation uses the same set of resources as one of the previous decollations.
Record Set records can be accessed through the Resource Sets (DO.2) screen. For
more information on the DO screen as related to Resource Sets, see Resource Sets
on page 354.

Implementing Decollation with Transformation

The process of creating a decollation definition for a print stream report involves
many more steps than creating a decollation definition for a regular text report.

In general, the process involves creating the following two preliminary decollation
definitions that are used to create the final decollation definition:

The first temporary decollation definition is used to check that all the resources are
available and that the Report Clique definition used in the decollation definition is
correct.

The second temporary decollation definition is used to create the correct text
version of the report.

These preliminary decollation definitions may be deleted later.

Specifically, the following steps are used to implement a decollation with

transformation:

1 Identify and collect all needed resources for the report. For more information see
Identifying and Collecting Resources on page 811.

2 Create the Report Clique. For more information see Creating Report Cliques on
page 811.

810 CONTROL-D and CONTROL-V User Guide

 Decollation of Report Types

3 Create a decollation mission including a Report Clique. This is the first preliminary
decollation definition. For more information see Creating a Decollation Mission
with a Report Clique (First Temporary Decollation Definition) on page 811.

4 View the report for verification. For more information see Viewing Normalized
Reports using CONTROL-D/WebAccess Server on page 812.

5 Check the Report Clique parameters are correct. For more information see
Verifying Report Clique Parameters on page 813.

6 Create a text report from the print stream report. This is the second preliminary
decollation definition. For more information see Creating a Text Report from the
Print Stream Report (Second Temporary Decollation Definition) on page 813.

7 Check and adjust the text report. For more information see Checking and
Adjusting the Text Report on page 815.

8 Define the decollation according to the text report. This is the final decollation
definition. For more information see Defining the Final Decollation Definition on
page 816.

9 View the decollated report. For more information see Viewing the Final Version
of the Report on page 817.

Identifying and Collecting Resources

To transform print stream reports, first identify and make available all report
resources (either for AFP or Xerox) needed for the decollation. Do this by defining the
Resource Library names in the $$TRNRES member of the CTD PARM library. For
more details about the $$TRNRES member see the chapter about managing resources
in the INCONTROL for z/OS Administrator Guide.

Creating Report Cliques

Create Report Cliques as needed. They are created and maintained using the DO.1
screen. For information on how to create Report Cliques, see Report Cliques on
page 329.

Creating a Decollation Mission with a Report Clique (First

Temporary Decollation Definition)
Create the first temporary decollation definition in order to the check that the
transformation is defined correctly, using the following guidelines:

The decollation definition should contain one DO NAME statement, and one DO
USER statement with a temporary or administrator recipient.

Chapter 6 Implementation Hints 811

Decollation of Report Types

BMC Software recommends creating a short version of the report (only a few
pages), and to use the ON TRNCLASS statement so that temporary CDAMs are
not created.

Specify the Report Clique using the CLIQUE parameter.

Viewing Normalized Reports using CONTROL-D/WebAccess

Server
If the decollation mission ends successfully, you can view the normalized report with
transformation using CONTROL-D/WebAccess Server version 3.2.00 or later, and
use indexes to view the report.

The report can be viewed in one of the following formats:

PDF (Document mode)

HTML (Page mode)

For information on the Report Clique rendering parameters used to transform reports
to PDF or HTML, see Rendering ParametersUnique to Text Report Cliques.

When you request to view a report with transformation, a transformer is activated

under the CONTROL-D for Distributed Systems and creates the transformed report
in either PDF or HTML format.

The transformer uses the Resource Set of the report to get the list of all the resources
that were used in the decollation. If a resource is not found in the local Resource
Manager of the CONTROL-D for Distributed Systems interface, the resource is taken
from the OS/390 Resource Manager. It then resides on the local File System Resource
Manager of the CONTROL-D for Distributed Systems interface, and does not need to
be taken again from the OS/390 Resource Manager in the future.

All the parameters that were defined in the Report Clique and relate to rendering are
used when viewing reports with transformation. For example, the Font Mapping
Table is used to map the original fonts of the report to TrueType fonts. For more
information, see Report Cliques on page 329.

PDF format

When a report is transformed to PDF format, the whole report, or an index section, is
transformed as one PDF file. For this reason, transformation to PDF is not
recommended for large reports without indexes.

812 CONTROL-D and CONTROL-V User Guide

 Decollation of Report Types

HTML format

When a report is transformed to HTML, the report is transformed only a few pages at
a time. This allows the user to view print stream reports in page-by-page mode in a
similar way to text reports.

Verifying Report Clique Parameters

If the report is displayed correctly, all Report Clique parameters were defined
correctly and all resources are available.

NOTE
If a report is extremely large, transformation can take a long time. In such cases, try to create a
special, smaller report with the same structure.

If a problem occurs, either the Report Clique must be fixed, or missing resources must
be added. Repeat the process of verifying and collecting resources and/or creating
Report Cliques, as necessary, until the report is displayed correctly.

Creating a Text Report from the Print Stream Report

(Second Temporary Decollation Definition)
After reviewing the result of the first temporary decollation definition, modify that
decollation definition by adding the GROUP parameter set to COLUMNIZE. The
GROUP parameter creates a text version of the report, containing text extracted from
the original page, in four orientations (0o,90o,180o,270o).

NOTE
BMC Software recommends giving a different PRINT/CDAM PARMS 'PREFIX=' parameter
to the columnized report, if LAST =Yes is used when viewing the report.

The following are specific requirements for the text page:

The text page contains only text lines, with each line beginning with a line number
according to the orientation of the text.
no empty lines are displayed
lines in orientation 0o begin with the numeral 0
lines in orientation 90o begin with the numeral 1
lines in orientation 180o begin with the numeral 2
lines in orientation 270o begin with the numeral 3

Chapter 6 Implementation Hints 813

Decollation of Report Types

Example

The following print stream report page

Figure 461 Print Stream Report Page Example

results in the following print stream report page:

--------- orientation = 000 (degrees)

00005 This is orientation 0
--------- orientation = 090 (degrees)
10007 This is orientation 90
--------- orientation = 180 (degrees)
20010 This is orientation 180
--------- orientation = 270 (degrees)
30017 This is orientation 270

The resulting text page is set according to the Number of Rows and Number of
Columns parameters defined in the Report Clique. Because the original text in the
document can be any size, if the text is defined with a very small font this may result
in many more words than expected displaying on the same line. If this occurs,
increase the number of rows and columns.

If text required for decollation is not displayed, increase the value of the Number of
Rows and/or Number of Columns parameters, and repeat the decollation.

814 CONTROL-D and CONTROL-V User Guide

 Decollation of Report Types

Checking and Adjusting the Text Report

Check and adjust the text report you created.

Checking the Text Report

When creating the text report, CONTROL-V superimposes a grid on the original
bitmap image of the report based on the settings for the Report Clique Number of
Rows and Number of Columns parameters (see CONTROL-D Report Clique
Definition Screen on page 332). The character in each cell in the grid is used to create
the contents of the text report.

The size of the cells in the grid can affect the contents of the outputted text report. You
should compare the text report against either the printed report or the version you
view using CONTROL-D/WebAccess to ensure that no characters required for the
decollation were lost.

The following are some problems with the grid cell sizes that may affect the text
report output:

If grid cells are too large, the resulting report may have cells that contain more than
one character, in which case characters are lost in the text report.

NOTE
The only characters of concern are those that may be used as values in the decollation
definition. Any lost characters not used in the decollation definition are irrelevant.

If grid cells are too small, extra blank spaces may be inserted into the text report.
Extra spaces in the text report is not a serious problem because repeating blanks in
the index values are automatically replaced by a single blank.

Adjusting the Text Version

If required characters are missing from the text version of the report, you need to
resize the grid by increasing the Number of Rows and Number of Columns
parameters in the Report Clique. Optimally, these numbers should be just large
enough to hold one character of the smallest font that you use in the decollation
definition.

Chapter 6 Implementation Hints 815

Decollation of Report Types

NOTE
If the orientation of the text is either 90o or 270o, then

changing the Number of Rows value adjusts what appears to be columns

changing the Number of Columns value adjusts what appears to be rows

Defining the Final Decollation Definition

Because decollation of print stream reports with transformation creates a Normalized
report instead of the original report in the CDAM, use the following guidelines when
defining the decollation mission:

Use a DO BACKUP statement to decollate the original report from SPOOL or from
DSN to one user with one name. Keep this CDAM for purposes of backup and
legal reasons.

Use an ON TRNDSN step to decollate the CDAM, distribute the report among
recipients, and create indexes. Use this report for viewing and migration.

NOTE
ON TRNCLASS can also be used to decollate with transformation directly from SPOOL.
However, decollation using this method does not save the original report.

Both ON TRNDSN and ON TRNCLASS decollations should use the CLIQUE

parameter with the following syntax:

CLIQUE=Report_Clique_Name

For more information on defining a decollation using either the TRNDSN or

TRNCLASS parameters, see the discussion of the ON subparameters in ON
Statement: Decollating Parameter on page 560, and the examples for TRNDSN
and TRNCLASS illustrated in that section.

An ON TRNCLASS or ON TRNDSN decollation mission (that is, without GROUP set

to COLUMNIZED) performs decollation according to the text version of the report,
but also creates a CDAM containing a Normalized report.

A Normalized report is a report created during the decollation mission that invokes
transformation. Each page of the Normalized report includes the relevant data and
references to all resources required for viewing or printing a specific page.

816 CONTROL-D and CONTROL-V User Guide

 Decollation of XML Reports

Use the text report you created in the step Creating a Text Report from the Print
Stream Report (Second Temporary Decollation Definition) on page 813, to define
necessary lines and columns for WHEN statements, and DO statements such as DO
NAME, DO USER, DO REMARK, DO INDEX.

Viewing the Final Version of the Report

View the Normalized report with the modifications you made according to the Text
Report. Make further modifications, as necessary.

Decollation of XML Reports

Decollate XML reports according to the following procedure:

1 In the decollation definition, set the PRINT/CDAM parameter ASSOC to XML,

either in an ON statement or in the SUBSYS parameter when the report is written
directly to CDAM.

2 Specify the encoding for the XML report either as an EBCDIC code page, ASCII
code page, or Unicode, in one of the following ways:

in the XML header tag, as follows:

<?xml version='1.0' encoding=...?>

by using the PRINT/CDAM ENCODING parameter (for more information on

the ENCODING parameter, see CDAM Control Parameters on page 763)

3 Because an XML report is usually treated as one page, set the PRINT/CDAM
LINECT parameter to a large enough number to prevent the report from being
split into pages according to the value of LINECT. For more information on the
LINECT parameter, see CDAM Control Parameters on page 763.

4 You can split an XML report into pages by setting the PRINT/CDAM XMLSEP
parameter to tagname. All data inside the specified tag name (that is, the tag name
within its surrounding angle brackets) is treated as a separate page. This feature is
available only for reports with EBCDIC encoding. For more information on the
XMLSEP parameter, see CDAM Control Parameters on page 763.

5 You can analyze the XML report contents and assign ownership by using the DO
SET decollation statement with the variable set to XPath expressions. For more
information on setting variables with DO SET, see DO SET: Decollating
Parameter on page 500.

Chapter 6 Implementation Hints 817

Decollation of XML Reports

6 You can view XML reports by invoking the XSLT processor using CONTROL-
D/WebAccess Server. This transforms the XML report into an HTML page
according to the specifications in the XSL stylesheet file.

818 CONTROL-D and CONTROL-V User Guide

 Decollation of XML Reports

Example
If the input XML document contains the following code,

<?xml version="1.0" encoding="IBM-1140" ?>

<invoices>
<date>14 Apr 2002</date>
<invoice>
<company name="ABC Corporation"/>
invoice data 1
</invoice>
<invoice>
<company name="XYZ Inc"/>
invoice data 2
</invoice>
</invoices>

and the decollation mission contains the following statements,

ON CLASS X
PRINT/CDAM PARAMETERS = ASSOC=XML,XMLSEP=invoice
DO SET %%COMPANY = </invoice/company/@name>
DO USER = %%COMPANY
DO NAME = INVOICE REPORT

the resulting report entries contain the following:

a report for the recipient with the synonym "ABC Corporation" and the report
name "INVOICE REPORT"

<invoice>
<company name="ABC Corporation"/>
invoice data 1
</invoice>

a report for the recipient with the synonym "XYZ Inc" and the report name
"INVOICE REPORT"

<invoice>
<company name="XYZ Inc"/>
invoice data 2
</invoice>

When the report entries are retrieved through CONTROL-D/Page on Demand, the
following are added to each report entry contents:

Chapter 6 Implementation Hints 819

Indexing Considerations

to the header:

<?xml version="1.0" encoding="IBM-1140" ?>

<invoices>
<date>14 Apr 2002</date>

to the footer:

</invoices>

Indexing Considerations

Report Design
To maximize the value and utility of CONTROL-V indexing, reports should collect
essential identifiers for report pages or sections in well defined, compact locations
that can be described by one line number or range and one column number range.
Separate indexes should be used for restricted (controlled) and free (uncontrolled)
index values.

Retrieval is faster when index values are left justified within an index field. Separate
fields should be used for different levels when index terms form a natural hierarchy.
For example:

bank branch account type Account #

last name first & middle name
area code phone or fax number
country state or province zip code

The entire index value (which cannot exceed 50 characters) must be contained on a
single line. The entire mask value (which cannot exceed 20 characters) must also be
contained on a single line. Column ranges for index and mask values must be on the
same page. These values may be the same, may overlap, or may have no overlap.

The presence of a record-level index value must be determined by the presence of a

mask value on the same page. The presence of a page-level index value can optionally
be determined by the presence of a mask value on the same page.

820 CONTROL-D and CONTROL-V User Guide

 Index Design

For example, on a bank statement the mask BRANCH may indicate that digits in a
specified nearby location represent the branch number. The mask ACCOUNT NO.
may indicate that digits in another specified nearby location are an account number.
Placing summary or grand total values on a separate page facilitates their retrieval.

Index Design
CONTROL-V enables users to retrieve parts of reports based on any predefined index
path. Define separate index paths for each meaningful way to retrieve a report page
or section. It is recommended that each index name be unique. When possible, use
page-level, rather than record-level, indexing. For example:

The following index paths may be specified for a life insurance policy file:

Path 1 for computing reserves and cash values:

1_pol_type, 1_policy_# , 1_face_amount, 1_riders, 1_rating, 1_issue_age,
1_issue_date

Path 2 for premium billing:

2_payment_mode, 2_state/country, 2_zipcode, 2_city, 2_bill_address,
2_pol_owner, 2_pol_# , 2_annual_prem

Path 3 for commission payments

3_payment_mode, 3_branch_ofc, 3_agent, 3_pol_type, 3_pol_# , 3_issue_date,
3_annual_prem, 3_comm_scale

In path 1 (above), 1_pol_type is a page-level index if only one policy type can occur
on a page. Likewise, in paths 2 and 3, payment_mode is a page-level index if only one
type of payment mode can occur on a page.

Index names should be as descriptive as possible. Use acct-name or account#

rather than account, use part-num or part-name rather than part, and so on.
Parameter MASK must be used to qualify a record-level index value. Whenever
possible, also use parameter MASK to qualify a page-level index value. Mask values
and index values must be on the same page of the report.

Index design requires an intimate knowledge of report layout and usage. When
possible, the programmer responsible for maintaining the report program and a user
who knows how the report is used should collaborate in designing indexes for the
report.

Chapter 6 Implementation Hints 821

Migrated vs. DASD-resident Indexes

Migrated vs. DASD-resident Indexes

Indexes that are seldom used after a report migrates, should themselves migrate.
Indexes that are often needed regardless of report location should remain on DASD.
Larger indexes should migrate. Smaller indexes should remain on DASD.

If an index is defined as non-resident, its name will only be checked during hit-list
processing, but the index file itself will not be opened and checked for an index value.
Therefore, the hit list can include reports which have a correspondent index, but do
not necessarily contain the requested index value.

Naming Conventions
An index file conforms to the following naming convention:

INDPREF.JOBNAME.DATE.TIME.FILEID

where:

INDPREF is the index file prefix. This prefix can have either of two structures,
depending on the length of the IXHPREF parameter in the CTVPARM member in
the IOA.PARM library:

If IXHPREF is 3 characters in length, INDPREF has following structure:

IXHPREF.IXPREF

where:

IXHPREF is the three- character, first-level prefix specified in the IXHPREF

parameter in the CTVPARM member. All indexes have the same IXHPREF
value.

IXPREF is the second-level prefix specified in the IXPREF parameter in the

CTVPARM member. All indexes have the same IXPREF value.

If IXHPREF is one or two characters long, INDPREF takes the value of the CDAM
file prefix with one of its characters changed to the value specified in the first
character of IXHPREF. Parameter IXPREF from CTVPARM is not used in this case.

If IXHPREF is one character, the first character of the CDAM prefix is replaced.

822 CONTROL-D and CONTROL-V User Guide

 Naming Conventions

For example, if IXHPREF=I and the CDAM file prefix is CTDP.L2, INDPREF is
ITDP.L2.

If IXHPREF is two characters, the second character is an integer from 1 to 7

representing the position number of the character that was replaced.

For example, if IXHPREF=I6 and the CDAM file prefix is CTDP.L2, INDPREF is
CTDP.I2.

DATE is the letter C, followed by the five-character date in julian format (yyddd).

TIME the letter T followed by 6 digits indicating the time in hhmmss format.

FILEID is the File ID beginning with the letter M, followed by one digit (from 1
through 9) which indicates the number of the monitor which created the index,
followed by the 3-digit sequential number of the index produced in the decollation
mission.

A primary migrated index conforms to the following naming convention:

PMIGXPREF.JOBNAME.DATE.TIME.FILEID

where PMIGXPREF is the file prefix. This prefix can have either of two structures,
depending on the length of the DSNPREF parameter in the IOASPRM member in the
IOA.PARM library. The length of this parameter should be the same as length of the
parameter IXHPREF in member CTVPARM.

If DSNPREF is 3 characters in length, PMIGXPREF is built as:

DSNPREF.IXPREF

where IXPREF is the second-level prefix specified in the IXPREF parameter in the
CTVPARM member.

If DSNPREF is one or two characters long, PMIGXPREF is built by inserting the

first DSNPREF character into the original index file prefix.

If DSNPREF is one character, it is inserted into the first position.

For example, if DSNPREF=M and the original index file prefix is ITDP.L2,
PMIGXPREF is MITDP.L2.

If DSNPREF is two characters long, the second character is an integer from 1 to

7, representing the number of the position into which the first DSNPREF
character is inserted.

Chapter 6 Implementation Hints 823

Index Size

For example, if DSNPREF=M6 and the original index file prefix is CTDP.I2,
PMIGXPREF is CTDP.MI2.

A secondary migrated index conforms to the following naming convention:

SMIGXPREF.JOBNAME.DATE.TIME.FILEID

where SMIGXPREF is the file prefix. This prefix can have either of two structures,
depending on the length of the SECPREF parameter in the IOASPRM member in the
IOA.PARM library. The length of this parameter should be the same as length of the
parameter IXHPREF in member CTVPARM.

If SECPREF is 3 characters in length, SMIGPREF is built as:

SECPREF.IXPREF

where IXPREF is the second-level prefix specified in the IXPREF parameter in the
CTVPARM member.

If SECPREF is one or two characters long, SMIGXPREF is built by inserting the first
SECPREF character into the original index file prefix, using the same method as
PMIGXPREF is built from DSNPREF.

For example, if SECPREF=S and the original index file prefix is ITDP.L2,
SMIGXPREF is SITDP.L2. If SECPREF=S6 and the original index file prefix is
CTDP.I2, SMIGXPREF is CTDP.SI2.

For both primary and secondary migration, the DATE field has the following format:

DATEWhen an index migrates from disk to the level 01 target media, this field
remains prefixed by the letter C. This letter is replaced by the next letter in
alphabetical sequence during each stage of the multi-stage migration or refresh. The
other qualifiers are copied from the original index name.

Index Size
Index size is a function of index field width, the number of different index values that
occur in the report, and how the report is sorted. Sorting affects index size because
each index entry contains a separate pair of pointers to the first and last page of each
nonconsecutive occurrence of the index value in the report. The indexes in an index
path are shorter when the report is sorted by the fields which comprise the index
path.

824 CONTROL-D and CONTROL-V User Guide

 Using Indexes for Retrieval

For example, a bank report may contain information about 10,000 accounts divided
among 10 account types at 50 branches. If the report is sorted by branch # , account
type, and account # , the account type index would have only 10 entries but each entry
could point to as many as 50 page ranges. If the same report were sorted by account
type, branch # , and account # , the account type index would still have 10 entries but
each entry would point to only one page range containing all the branch # values per
account type entry.

Using Indexes for Retrieval

Index values can be used to retrieve report pages or sections. All pages or sections
which are pointed to by the selected index values are made available for online
viewing, printing, and so on, regardless of where the report is stored.

Index values can be specified through the User Reports entry panel, through a Values
of Index panel (option X in the Active User Report list followed by option S in the
Main Index window), or through a Quick Access panel (option Q in the User Reports
entry panel, the Active User Report list, or the Main Index window).

Enter Q in the User Reports entry panel bypass panel field to suppress the display of
this entry panel, and immediately display the Quick Access Report list or Quick
Access panel when entering the User Reports facility.

Use the Index window to list all main indexes for a report. You can select a main
index or display the Quick Access panels from this window.

Use the Values of Index panel to display an alphabetized list of all values that exist in
a specified index. Use option V to view report pages pointed to by the selected
indexes or use option X to display the names of subindexes under any index value in
the list.

Use a Quick Access panel to optionally specify subindex values. Place an asterisk or
prefix in a subindex value field to display the Values of Index panel for that subindex.
When the Quick Access panel contains the desired index values, press Enter to view
report pages pointed to by those values.

Testing Indexes
After report indexes have been defined, they should be tested to be sure they index
the report output in the way expected. The best way to test indexes is to run the
decollating missions containing them.

Chapter 6 Implementation Hints 825

Printing Considerations

If no indexes are produced, rerun the decollation mission on a few pages of the report
with index value masks set to an asterisk. Examine the index values produced by the
modified index specification. Determine if an error was made in calculating the line
and column ranges for the index values and/or mask values.

Printing Considerations

Printing Organization
Organizing the printing of bundles is a potentially complicated process. Bundle
organization can be seen from several different points of view, each possibly
conflicting with the others. These points of view and recommended solutions are
discussed below.

Computer Operators Point of View

Printing is a process which is governed by physical constraints:

There are several types of printers. Some reports can only be printed on specific
printers. For example: Reports which contain logical character sets and/or
graphics cannot be printed by an impact printer. Reports which must be produced
with carbon paper copies cannot be printed by a laser printer.

There are several types of paper: wide, narrow, blue form, carbon, yellow, and so
on.

With laser printers (for example, 3800) it is possible to use physical FLASH. This
requires manual intervention by the operator before printing starts.

With some laser printers, the process of switching from one character set to
another may take 10 to 20 seconds.

In impact printers, the ribbon may have to be replaced.

The physical constraints described above tend to negate the main purpose of a report
distribution system, which is to print all the reports of one user in one bundle.

It is physically impractical to print one bundle for a user containing different types of
paper (for example). The operator cannot replace the paper in the printer every few
pages. Therefore, it is clear that some physical constraints must be considered when
planning the printing process.

826 CONTROL-D and CONTROL-V User Guide

 Printing Organization

In summary, from the operators point of view, it is desirable to print all the blue
paper together, narrow paper together, and so on.

Dispatcher and Distributors Point of View

Report dispatchers have different needs. They would like all reports of a user
packaged in one bundle. If this is physically impossible, they want the minimum
number of bundles per user.

The dispatchers want bundles printed according to their distribution network. Lets
consider this issue further. When regular printing takes place (without a report
distribution system), the entire report must be printed in order to print the last user in
the report.

Suppose, for example, that a report is sorted according to branches, and the newest
branch in the bank (branch 812) appears last in all reports. Furthermore, the courier
who delivers the material to this new branch must leave before all the other couriers,
because the branch is located very far away.

In this case, unwanted delays occur when the printer is busy printing reports which
could be printed at a later time (all the report pages before those of branch 812),
instead of printing reports (for branch 812) which are needed immediately. What is
needed is the capability to print bundles according to distribution priorities derived
from the delivery schedule.

A bank, for example, has a distribution organization. Reports belonging to different

recipients located in the same area are packaged together and special couriers have to
leave not later than a specified time in order to reach their destination in time. The
following is a simplified example:

Assume that the distribution area is divided between distribution couriers and
destination points as follows:

North county Northeast county

Courier # 1 Courier # 2

latest 5 A.M. latest 5:30 A.M.

Central Branch Management

Courier # 5 Pickup at

latest 7 A.M. 7:30 A.M.

South county Airport

Courier # 3 Courier # 4

latest 6 A.M. latest 6 A.M.

Chapter 6 Implementation Hints 827

Printing Organization

Each courier takes a few packages containing reports to be distributed within that
couriers area. The courier should not leave after the specified time. (In the above
example, management is physically located in the same building where reports are
printed. Management reports are not delivered, but most be ready for pickup by 7:30
A.M.)

As we can see from the diagram, the preferred printing order from the point of view
of the dispatchers and distributors is: Courier # 1, # 2, # 3, # 4, # 5 and Management.
Printing in this order increases the probability that the reports get to their destination
on time.

The order described above is the normal preferred printing order. However, it is
sometimes necessary to print in a different order. For example: The airport is about to
be closed very early because of weather conditions. Therefore, the airport courier
should leave earlier, so those reports should be printed first. A solution for such
requirements can be very helpful to the data center in providing high level service to
its customers.

Printing Organization
The suggested printing organization should answer the problems of the operators,
the dispatchers, and the distributors, to the extent that is physically possible, given
the printing constraints discussed above.

A printing mission should be defined for every physical printing constraint (that is,
paper type, flash, and so on). The name of the printing mission should be meaningful.
For example:

STD
132PAPER
80PAPER
BLUEPAPR
CARBON10
CARBON18
FLASH272
FLASH273

NOTE
Different missions have to be defined only for actual physical constraints. Logical printing
characteristics do not require a separate bundle. For example, it is possible to mix different
CHARS and MODIFY parameters in the 132PAPER printing mission.

Printing missions are defined using the Online facility (option M). Each printing
mission can be composed of many categories. In our sample case, each printing
mission is composed of the following categories:

828 CONTROL-D and CONTROL-V User Guide

 Printing Organization

C#1-NORTH-COUNTY
C#2-NORTHEAST-COUNTY
C#3-SOUTH-COUNTY
C#4-AIRPORT
C#5-CENTRAL-BRANCH
MANAGEMENT-BOX

Each category represents a distribution area. In the definition of each category we can
use INCLUDE/EXCLUDE statements for all the report recipients which are located
in the distribution area. Normally, it is not necessary to specify the names of all the
users in the bank. Since the banks structure and the banks hierarchy (as reflected in
the Recipient Tree) generally correspond to the real distribution of the recipients, it is
usually sufficient to specify the name of the parent in the tree. For example,
specifying the recipient NORTH Regional Management automatically includes all its
descendants in the tree (that is, all the branches in the north county). If one of those
branches can be reached more conveniently by the central branch courier, that branch
(and its departments) can be EXCLUDEd from the NORTH-COUNTY category, and
INCLUDEd in the CENTRAL BRANCH category.

The operator control screen contains one line for each category. Example:

132PAPER C#1-NORTH-COUNTY PRINTING ENDED OK

132PAPER C#2-NORTHEAST-COUNTY PRINTING
132PAPER C#3-SOUTH-COUNTY WAITING FOR PRINTER
132PAPER C#4-AIRPORT WAIT SCHEDULE
132PAPER C#5-CENTRAL-BRANCH WAIT SCHEDULE
132PAPER MANAGEMENT-BOX WAIT SCHEDULE
FLASH272 C#1-NORTH-COUNTY PRINTING ENDED OK
FLASH272 C#2-NORTHEAST-COUNTY PRINTING ENDED OK
FLASH272 C#3-SOUTH-COUNTY PRINTING ENDED OK
FLASH272 C#4-AIRPORT PRINTING ENDED OK
FLASH272 C#5-CENTRAL-BRANCH PRINTING ENDED OK
FLASH272 MANAGEMENT-BOX PRINTING ENDED OK

Using the Online facility, the operator is always aware of the status of the nights
processing. The operator can request to see a subset of the printing missions list by
using the online query window (for example, only blue paper, only management
box). The operator can control each bundle independently, and can hold it, change its
priority, and so on.

It is not mandatory to define multiple categories for each printing mission. Some
printing missions can contain only one category under which all the reports are
printed. The sort order of the users in the bundle can be controlled using the bundle
parameter SORT. This method is usually used for reports which are produced on
special types of paper and are all delivered to one recipient (for example, receipts,
bills).

Chapter 6 Implementation Hints 829

Using OUTPARM for Global Control of Printing Characteristics

Using this method, the number of bundles is minimized and the operator has full
control over the process.

Using OUTPARM for Global Control of Printing Characteristics

The CONTROL-V Global Control of Printing Characteristics option provides the
ability to override the default printing characteristics (specified at decollation time)
for all (or some) of the reports and banners to be printed by CONTROL-V. For more
information, see the CONTROL-D and CONTROL-V chapter of the INCONTROL for
z/OS Administrator Guide.

Controlling the Printing Sequence

Every bundle is a category in a printing mission. It is possible to use the standard
runtime scheduling parameters in order to control the sequence by which bundles are
printed. For example, if you specify higher priority for the couriers that have to leave
earlier, they are printed before other bundles with lower priorities (for example,
NORTH-COUNTY has higher printing priority than the SOUTH-COUNTY).

It is also possible to define mission dependencies using the prerequisite condition

concept. For example: the 132PAPER mission for the management box starts printing
only if the SOUTH-COUNTY/80PAPER mission has finished.

Printing missions can be triggered automatically or manually. Consider the following

scenario:

1. The job that produces the report to be printed on blue paper has been decollated by
CONTROL-V.

2. The operator is notified with a highlighted, unrollable message to place the blue
paper on the printer and to let CONTROL-V know when the printer is ready. This
is done using the Shout facility.

3. The operator places the paper in the printer, defines it for exclusive use by
CONTROL-V and starts the printer under CONTROL-V (if it wasnt already open).
For more information, see the CONTROL-D and CONTROL-V chapter of the
INCONTROL for z/OS Administrator Guide.

4. The operator enters the manual conditions list and specifies A (Add) next to the
prerequisite condition BLUE-PAPER-READY. As a result, the printing mission
starts executing.

830 CONTROL-D and CONTROL-V User Guide

 Workload Considerations

Workload Considerations
It is sometimes impractical to wait until all the 132-character width reports are
decollated and then to print all of them in bundles, because it takes too long to
complete. In such cases, it is possible to make two printing rounds for 132-character
width paper: one at midnight and one in the morning. Although it means one more
bundle to handle, this method ensures that the reports are printed on time.

Weekend Distribution
The distribution network may work differently on weekends. Instead of six couriers,
only three couriers are used, and the areas are divided in a completely different way
(for example, part of the northeast county is delivered by the airport courier). In such
cases, it is possible to create special printing mission categories for weekend
processing. They contain different INCLUDE and EXCLUDE parameters from the
printing missions used for daily processing.

The weekend category and the daily category should have different basic scheduling
criteria (for example, different WDAYS). They are then automatically scheduled by
CONTROL-V. Refer to the CONTROL-D and CONTROL-V chapter of the
INCONTROL for z/OS Administrator Guide for information about how to schedule
printing missions.

Report Decollating Missions and Printing Missions The Link

The means by which a report is printed are defined in the report decollating mission.
For example:

WHEN LINE 00001 - 00003 COL 00020 - 00080

STRING ACCOUNTS RECEIVABLE - DAILY
DO PRINT BY 132PAPER
DO ....
WHEN LINE 00005 - 00005 COL 00020 - 00080
STRING ACCOUNTS RECEIVABLE - BILLS
DO PRINT BY BLUEPAPR
DO ....

As you can see, the job produces two reports. One must be printed on regular
132-character paper. The other must be printed on a special paper type nicknamed
BLUEPAPR.

The printing mission name can be modified in the Permanent and Active User Report
lists.

Chapter 6 Implementation Hints 831

Specifying Report Destination

Specifying Report Destination

When defining reports in CONTROL-V, the printing destination of the reports should
be taken into consideration. CONTROL-V provides several ways to define the
printing destinations to print user bundles (containing all reports for a specific
recipient) or specific reports. For more information, see Destination CONTROL-V
Search Order on page 833.

Destination consists of two values a node and a user ID each value containing up
to eight characters. However, the value of the DEST parameter for ON statement
DEFAULTS and PRINT/CDAM PARMS is a single 8-character value.

Sending Entire User Bundle to a Specific Destination

When all reports assigned to a specific recipient should be sent to a specific
destination, designate the printing destination in the DEF DEST field for that
recipient in the Recipient Tree.

Sending Specific Reports to Specific Destinations

When specific reports (as opposed to an entire user bundle) should be sent to specific
destinations, specify the destination in the DEST field of the report in the User Report
list. The DEST field can be updated either in the Permanent User Report list for a
permanent specification, or in the Active User Report list for a one-time specification.

When using this method, subparameter SEARCH of the DO USER statement in the
report decollating mission for this report must be defined as either:

P(Permanent) CONTROL-V automatically assigns to the report the destination

specified in the Permanent User Report list.

A(Active) CONTROL-V automatically assigns to the report the destination

specified in the Active User Report list.

If the report DEST field in the Active User Report list is manually updated for a one-
time specification after the report is already decollated, it is not necessary to specify
the SEARCH subparameter in the report decollating mission of the job.

For more information about parameter SEARCH, utility CTDCP2A, and how this
method works, refer to the CONTROL-D and CONTROL-V chapter of the
INCONTROL for z/OS Administrator Guide.

832 CONTROL-D and CONTROL-V User Guide

 Sending Reports to the Original Destination from Spool

Sending Reports to the Original Destination from Spool

When the original destination of a report, as it appears on the system spool, should be
the destination of the report, enter *SPOOL in the DEST field of the JOB DEFAULTS
or ON Statement Defaults in the report decollating mission. This method is very
useful for generic decollating missions because the job name is usually not known in
advance.

Sending Reports to a Specific Destination

To route the whole report to a specific destination, the CDAM DEST parameter can be
specified either in the PRINTING/CDAM PARMS field of the report decollating
mission, or as a SUBSYS subparameter in the JCL of the job producing the report. In
either case, DEST *SPOOL must be specified in the DEST field of the JOB DEFAULTS
or ON Statement Defaults field of the report decollating mission. For more
information, see Destination CONTROL-V Search Order on page 833.

Sending Reports to a Specific External Writer

To route the whole report to a specific external writer, the External Writer name
should be specified either in the PRINT/CDAM PARMS field of the report
decollating mission, or as a subparameter of SYSOUT in the JCL of the job producing
the report. In either case, the %%EWTR parameter must be specified in the DEST field
of the DECOLLATION DEFAULTS or ON Statement Defaults field of the report
decollating mission.

Sending Unidentified Pages to a Specific Destination

To print all unidentified pages at a specific destination, specify that destination in the
DEST field of the ON Statement DEFAULTS (applies to all unidentified pages in the
particular ON statement) or the JOB DEFAULTS in the decollating mission of the job
(applies to all unidentified pages not specified in ON statements in the job).

Destination CONTROL-V Search Order

CONTROL-V searches for a specified or default print destination in the following
order and uses the first non-blank value that is found:

Chapter 6 Implementation Hints 833

Destination CONTROL-V Search Order

DEST field of parameter OVERRIDE in the printing mission

DEST parameter in the OUTPARMS library

DEST field in the Print Option window (using option P in the User Report List
screen)

DEST field for a specific report in the Active or Permanent User Report list,
depending on the SEARCH parameter destination in the report decollating
mission

If *SPOOL is specified in the DEST field of ON statement DEFAULTS:

The DEST field of PRINT/CDAM PARMS

The original SYSOUT destination

If *SPOOL is specified in the JOB DEFAULTS DEST field:

The DEST field of PRINT/CDAM PARMS

The original SYSOUT destination

NOTE
If any value other than *SPOOL is specified, the destination is applicable to unidentified
reports only.

DEF DEST field in the Recipient Tree

DEST field of parameter PRINTER in the printing mission

DEST of the printer defined in installation parameter CTDPARM

834 CONTROL-D and CONTROL-V User Guide

 Appendix

A
Editing Mission Definitions in the
A

IOA Edit Environment

Mission definition parameters can be edited (moved, copied, deleted, repeated) by
performing IOA line editing commands, similar to standard ISPF line commands,
from within the IOA Edit environment.

The Edit environment in a Mission Definition screen is accessed by typing EDIT in

the COMMAND field and pressing Enter.

Figure 462 Edit Environment in The Mission Definition Screen

--------- CONTROL-D/V CATEGORY DAILY JOB DAYTASK ----------(R.S)

COMMAND ===> SCROLL===> CRSR
+-----------------------------------------------------------------------------+
__ CATEGORY DAILY JOBNAME DAYTASK GENERIC MONITOR
__ OWNER M22 TASKTYPE REP GROUP DAILY-JOB JOBID
__ DESC INVENTORY AND EMPLOYEE SAMPLE REPORTS
__ DESC
__ ===========================================================================
__ DAYS DCAL
__ AND/OR
__ WDAYS ALL WCAL
__ MONTHS 1- Y 2- Y 3- Y 4- Y 5- Y 6- Y 7- Y 8- Y 9- Y 10- Y 11- Y 12- Y
__ DATES
__ CONFCAL SHIFT RETRO N MAXWAIT 00
__ MINIMUM PDS
__ ===========================================================================
__ IN PLRPT010-ENDED-OK ODAT
__ WHEN IN QUEUE Y CLS TIME FROM 0100 UNTIL 0630 INTERVAL 001 PRIORITY
__ DSN
__ ===========================================================================
__ OUT
__ SHOUT WHEN NOTOK TO OPER2 URG R
__ MSG ==== REPORT DECOLLATION FOR REPORT1 ENDED N O T O K ====
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 15.15.24

A 2-character line editing command field, marked by underscores, is displayed for

each line on the screen.

Appendix A Editing Mission Definitions in the IOA Edit Environment 835

 Editing commands are typed directly onto these underscores.

Incorrectly specified line editing commands can be corrected by typing over them
correctly. Line editing commands can be deleted by blanking them out or by
specifying the RESET command in the COMMAND field.

Specified line editing commands are processed when Enter is pressed.

CONTROL-V performs automatic syntax checking to ensure that the mission

definition is syntactically correct after editing. If an edit invalidates the mission
definition, a message is displayed at the top of the screen and the edit is not
performed. For editing mission definitions, see Maintaining Valid Mission
Definitions in this appendix for guidelines and recommendations.

All operations available in a Mission Definition screen can be performed while in the
Edit environment (for example, parameter values can be changed, the mission can be
saved, and the screen exited).

To exit the Edit environment, retype EDIT in the COMMAND field and press Enter.
Line editing command fields are removed from the display.

Line editing commands can be performed on the following:

Table 283 Subjects for Line Editing Commands

Subject Description
Single Lines One single line on the screen.

Examples:

Additional lines of parameter IN.

Single lined DO statements (such as DO COND).
Logical Lines All parameter lines for a specific parameter, including its subparameters.

Examples:

Statement DO SHOUT, whose subparameters are distributed over

more than one line.
Single lined DO statements (such as DO COND).
Logical Blocks Functional group of parameter lines.

Example:

ON block, which consists of its parameter lines and DO statement lines.

Multiple Lines User-specified group of parameter lines.

Example:

A series of DO statements.

836 CONTROL-D and CONTROL-V User Guide

 Line Editing Commands

Line Editing Commands

The following types of line editing commands exist in the Edit environment.

Table 284 Delete Commands

Command Effect
DS Delete a single line.
DL Delete a logical line.
DB Delete a logical block.
DD Delete lines between two DD specifications.
D Delete a line. CONTROL-V determines whether to delete a single or
logical line based on the line type.

Table 285 Copy Commands

Command Effect
CS Copy a single line.
CL Copy a logical line.
CB Copy a logical block.
CC Copy lines between two CC specifications.
C Copy a line. CONTROL-V determines whether to copy a single or logical
line based on the line type.
Copy commands are used in conjunction with Location commands. The lines or blocks are
placed at the position indicated by Location command A or B (described below).

Table 286 Move Commands

Command Effect
MS Move a single line.
ML Move a logical line.
MB Move a logical block.
MM Move lines between two MM specifications.
M Move a line. CONTROL-V determines whether to move a single or
logical line based on the line type.
Move commands are used in conjunction with Location commands. The lines or blocks are
placed at the position indicated by Location command A or B (described below).

Table 287 Repeat Commands (part 1 of 2)

Command Description
RS Repeat a single line.
RL Repeat a logical line.

Appendix A Editing Mission Definitions in the IOA Edit Environment 837

Maintaining Valid Mission Definitions

Table 287 Repeat Commands (part 2 of 2)

Command Description
RB Repeat a logical block.
RR Repeat lines between two RR specifications.
R Repeat a line. CONTROL-V determines whether to repeat a single or
logical line based on the line type.
The repeated lines or blocks are placed immediately after the lines or blocks that has been
repeated.

Table 288 Insert Commands

Command Description
I (Insert) Insert a new logical line or block after the logical line or block marked
with an I.

Table 289 Location Commands

Command Description
Indication of the position where lines or blocks should be placed.
A (After) Indicates that lines or blocks should be placed after the line marked with
an A.
B (Before) Indicates that lines or blocks should be placed before the line marked with
a B.
Location commands A and B are used in conjunction with Copy (C, CS, CL, CC, CB), and
Move (M, MS, ML, MM, MB) commands.

Maintaining Valid Mission Definitions

Since mission definitions must be syntactically correct at all times, the user should
consider the following issues when specifying line editing commands:

The result of a line editing command is dependent on the line on which the
command is specified. For example, command D deletes either a single or a logical
line based on the line type.

Logical lines form a unit and cannot be separated.

When a logical command is specified within a logical line (that is, on a

subparameter line or a continuation line), the specified operation is performed on
the entire logical line.

Block commands should be specified on the main lines of the block.

838 CONTROL-D and CONTROL-V User Guide

 Maintaining Valid Mission Definitions

A separator line must exist between blocks and cannot be deleted.

Blank parameter lines are added automatically by CONTROL-V (to allow the user
to specify additional parameters) and cannot be deleted.

BMC Software recommends that, wherever possible, commands D, C, M and R be

used for editing (instead of DS, DL, CS, CL, MS, ML, RS and RL) because these
commands automatically retain the logical structure of the mission definition.

Example 1
Before: Insert an additional DO statement in a DO block using command I (Insert).

Figure 463 Example 1 - Inserting Additional DO Statement - Before

------- CONTROL-D/V CATEGORY DAILY JOB * R.S)

COMMAND ===> SCROLL===> CRSR
+-----------------------------------+
__ CATEGORY DAILY JOBNAME * GENERIC Y MONITOR 1
__ ===========================================================================
__ DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
__ ===========================================================================
__ ON CLASS = W EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
__ PRINT/CDAM PARMS =
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
I_ DO NAME = PRODUCTION JCL LINE COL -
__ DO USER = PRODCNTL LVL LINE COL - S N T
SYNONYM = CONCAT =
__ DO BACKUP = BKP0007D
__ DO USER = OPERATE LVL LINE COL - S A T
SYNONYM = CONCAT =
__ DO USER = OPERMGMT LVL LINE COL - S A T
SYNONYM = CONCAT =
__ DO
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 17.29.18

After: An additional DO statement line has been opened.

Appendix A Editing Mission Definitions in the IOA Edit Environment 839

Maintaining Valid Mission Definitions

Figure 464 Example 1 - Inserting Additional DO Statement - After

------- CONTROL-D/V CATEGORY DAILY JOB * (R.S)

COMMAND ===> SCROLL===> CRSR
+------------------------------------+
__ CATEGORY DAILY JOBNAME * GENERIC Y MONITOR 1
__ ===========================================================================
__ DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
__ ===========================================================================
__ ON CLASS = W EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
__ PRINT/CDAM PARMS =
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO NAME = PRODUCTION JCL LINE COL -
__ DO
__ DO USER = PRODCNTL LVL LINE COL - S N T
SYNONYM = CONCAT =
__ DO BACKUP = BKP0007D
__ DO USER = OPERATE LVL LINE COL - S A T
SYNONYM = CONCAT =
__ DO USER = OPERMGMT LVL LINE COL - S A T
SYNONYM = CONCAT =
__ DO
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 17.29.33

Example 2
Before: Delete the ON CLASS A block. Using the DB (Delete Block) command is the
preferred method. The DB command removes all parameters, comments,
continuation lines, and separator lines of the specified block. DB must be specified on
a main line of the block (that is, ON CLASS).

840 CONTROL-D and CONTROL-V User Guide

 Maintaining Valid Mission Definitions

Figure 465 Example 2 - Use of Delete Block Command - Before

------- CONTROL-D/V CATEGORY DAILY JOB * (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------+
__ CATEGORY DAILY JOBNAME * GENERIC Y MONITOR 1
__ ===========================================================================
__ DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
__ ===========================================================================
DB ON CLASS = A EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
__ PRINT/CDAM PARMS =
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO NAME = PRODUCTION JCL LINE COL -
__ DO USER = PRODCNTL LVL LINE COL - S N T
SYNONYM = CONCAT =
__ DO BACKUP = BKP0007D
__ DO
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO
__ ===========================================================================
__ ON CLASS = B EXTWTR DEST FORM
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 18.37.54

After: The ON CLASS A block has been deleted.

Figure 466 Example 2 - Use of Delete Block Command - After

------- CONTROL-D/V CATEGORY DAILY JOB * (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------+
__ CATEGORY DAILY JOBNAME * GENERIC Y MONITOR 1
__ ===========================================================================
__ DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
__ ===========================================================================
__ ON CLASS = B EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS =
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO NAME = PRODUCTION JCL LINE COL -
__ DO
__ ===========================================================================
__ ON
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS =
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO
======= >>>>>>>>>> END OF JOB/REPORT PARAMETERS FOR THIS CATEGORY <<<<<<< =====

FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 18.39.54

Appendix A Editing Mission Definitions in the IOA Edit Environment 841

Maintaining Valid Mission Definitions

Example 3
Before: Move multiple DO statements from one ON block to another. Command MM
(Multiple Move) is specified at the beginning and the end of the DO statements that
are moved. Command A (After) specifies the location after which these lines are
placed.

Figure 467 Example 3 - Use of Multiple Move Command - Before

------- CONTROL-D/V CATEGORY DAILY JOB * (R.S)
COMMAND ===> SCROLL===> CRSR
+------------------------------------+
__
LINE - COL - PRINT REF NEXT PAGE CONTID AND/OR
__ STRING =
__ DO NAME = PRODUCTION JCL LINE COL -
MM DO USER = NONPRODCNTL LVL LINE COL - S N T
SYNONYM = CONCAT =
__ DO BACKUP = BKP0007D
__ DO SHOUT TO TSO-001 URGENCY
MM = NON-PRODUCTION JCL COMPLETED
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO
__ ===========================================================================
__ ON CLASS = B EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
__ PRINT/CDAM PARMS =
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
A_ DO NAME = NON-PRODUCTION JCL LINE COL -
__ DO
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 18.47.45

After: The three specified DO statements have been moved to the specified location.

842 CONTROL-D and CONTROL-V User Guide

 Maintaining Valid Mission Definitions

Figure 468 Example 3 - Use of Multiple Move Command - After

------- CONTROL-D/V CATEGORY DAILY JOB * - (R.S)
COMMAND ===> SCROLL===> CRSR
+------------------------------------+
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO NAME = PRODUCTION JCL LINE COL -
__ DO
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO
__ ===========================================================================
__ ON CLASS = B EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
__ PRINT/CDAM PARMS =
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO NAME = NON-PRODUCTION JCL LINE COL -
__ DO USER = NONPRODCNTL LVL LINE COL - S N T

__ DO BACKUP = BKP0007D
__ DO SHOUT TO TSO-001 URGENCY R

FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 18.50.58

Example 4
Before: Copy a WHEN statement and some of its DO statements to another WHEN
statement. Command CC (Multiple Copy) is specified at the beginning and the end of
the lines that are copied. Command B (Before) specifies the location before which
these lines are placed.

Figure 469 Example 4 - Use of Multiple Copy Command - Before

------- CONTROL-D/V CATEGORY DAILY JOB * (R.S)
COMMAND ===> SCROLL===> CRSR
+-----------------------------------+
__ ON CLASS = A EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
__ PRINT/CDAM PARMS =
CC WHEN LINE 00001 - 00001 COL - PRINT REF NXT CT AND/OR
__ STRING = DD
__ DO NAME = PRODUCTION JCL LINE COL -
CC DO USER = PRODCNTL LVL LINE COL - S N T
SYNONYM = CONCAT =
__ DO BACKUP = BKP0007D
__ DO
B_ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO
__ ===========================================================================
__ ON CLASS = C EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS =
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 18.57.05

Appendix A Editing Mission Definitions in the IOA Edit Environment 843

Maintaining Valid Mission Definitions

After: The specified WHEN and DO statements have been successfully copied.

Figure 470 Example 4 - Use of Multiple Copy Command - After

------- CONTROL-D/V CATEGORY DAILY JOB * (R.S)
COMMAND ===> SCROLL===> CRSR
+------------------------------------+
__ ON CLASS = A EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
__ PRINT/CDAM PARMS =
__ WHEN LINE 00001 - 00001 COL - PRINT REF NXT CT AND/OR
__ STRING = DD
__ DO NAME = PRODUCTION JCL LINE COL -
__ DO USER = PRODCNTL LVL LINE COL - S N T
SYNONYM = CONCAT =
__ DO BACKUP = BKP0007D
__ DO
__ WHEN LINE 00001 - 00001 COL - PRINT REF NXT CT AND/OR
__ STRING = DD
__ DO NAME = PRODUCTION JCL LINE COL -
__ DO USER = PRODCNTL LVL LINE COL - S N T

__ DO
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
__ STRING =
__ DO
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 18.58.32

Example 5
Before: Insert a continuation line between existing continuation lines. It is
recommended that command R (Repeat) be used to repeat the previous logical line.

844 CONTROL-D and CONTROL-V User Guide

 Maintaining Valid Mission Definitions

Figure 471 Example 5 - Use of Insert Command - Before

------- CONTROL-D/V CATEGORY DAILY JOB * (R.S)
COMMAND ===> SCROLL===> CRSR
+------------------------------------+
__ CATEGORY DAILY JOBNAME * GENERIC Y MONITOR 1
__ ===========================================================================
__ DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
__ ===========================================================================
__ ON CLASS = W EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
__ PRINT/CDAM PARMS =
__ WHEN LINE 00001 - 00002 COL 00005 - PRINT REF NXT CT AND/OR
__ STRING = DD
R_ WHEN LINE 00003 - 00003 COL 00005 - PRINT REF NXT CT AND/OR
__ STRING = DISK
__ WHEN LINE 00004 - 00004 COL 00005 - PRINT REF NXT CT AND/OR
__ STRING = TAPE
__ DO NAME = PRODUCTION JCL LINE COL -
__ DO USER = PRODCNTL LVL LINE COL - S N T
SYNONYM = CONCAT =
__ DO BACKUP = BKP0007D
__ DO
__ WHEN LINE - COL - PRINT REF NXT CT AND/OR
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 19.17.29

After: The continuation line has been repeated. The repeated line can be modified as
necessary.

Figure 472 Example 5 - Use of Insert Command - After

------- CONTROL-D/V CATEGORY DAILY JOB * (R.S)
COMMAND ===> SCROLL===> CRSR
+------------------------------------+
__ CATEGORY DAILY JOBNAME * GENERIC Y MONITOR 1
__ ===========================================================================
__ DEF COPIES 01 LVL USER UNIDENT DEST MAX COPIES
__ ===========================================================================
__ ON CLASS = W EXTWTR DEST FORM
__ PRT COPIES LVL USER DEST MAX COPIES
__ PRINT/CDAM PARMS = ALLOCOPT=JOBSDSN1
__ PRINT/CDAM PARMS =
__ WHEN LINE 00001 - 00002 COL 00005 - PRINT REF NXT CT AND/OR A
__ STRING = DD
__ WHEN LINE 00003 - 00003 COL 00005 - PRINT REF NXT CT AND/OR A
__ STRING = DISK
__ WHEN LINE 00003 - 00003 COL 00005 - PRINT REF NXT CT AND/OR A
__ STRING = DISK
__ WHEN LINE 00004 - 00004 COL 00005 - PRINT REF NXT CT AND/OR
__ STRING = TAPE
__ DO NAME = PRODUCTION JCL LINE COL -
__ DO USER = PRODCNTL LVL LINE COL - S N T
SYNONYM = CONCAT =
__ DO BACKUP = BKP0007D
FILL IN REPORT DEFINITION. CMDS: EDIT, SCHED, SHPF, PATH 19.18.40

Appendix A Editing Mission Definitions in the IOA Edit Environment 845

Maintaining Valid Mission Definitions

846 CONTROL-D and CONTROL-V User Guide

 Appendix

B
B Shout Facility Variables
CONTROL-V Shout facility variables are predefined variables whose values are
automatically updated at the time the SHOUT message is issued. The format of the
system variables is similar to those in the AutoEdit facility:

%%var

where var represents the name of the system variable.

Each system variable resolves to the corresponding system value at the time the
SHOUT message is issued.

Example

SHOUT WHEN NOTOK TO OPER2-1 URGENCY U

MSG Decollating of %%JOBNAME ended abnormally.

System Variables
Table 290 System Variables (part 1 of 2)
Variable Description
%%ODATE Original date of the mission (format yymmdd).
%%OYEAR Original year of the mission (format yy).
%%OMONTH Original month of the mission (format mm).
%%ODAY Original day of the mission (format dd).
%%OWDAY Original day of the week of the mission. Format is d, where d is 1
through 6 or 0 (for example, 1 is Sunday, 2 is Monday, ... 6 is Friday, 0 is
Saturday).a
%%OJULDAY Original day of the mission in the year (Julian format jjj).
%%RDATE Current working date (format yymmdd).

Appendix B Shout Facility Variables 847

System Variables

Table 290 System Variables (part 2 of 2)

Variable Description
%%RYEAR Current working year (format yy).
%%RMONTH Current working month (format mm).
%%RDAY Current working day (format dd).
%%RWDAY Current working day of the week. Format is d, where d is 1 through 6 or
0 (for example, 1 is Sunday, 2 is Monday, ... 6 is Friday, 0 is Saturday).a
%%RJULDAY Current working day of the year (Julian format jjj).
%%DATE Current system date (format yymmdd).
%%YEAR Current system year (format yy).
%%MONTH Current system month (format mm).
%%DAY Current system day (format dd).
%%WDAY Current system day of the week. Format is d, where d is 1 through 6 or 0
(for example, 1 is Sunday, 2 is Monday, ... 6 is Friday, 0 is Saturday).a
%%JULDAY Current Julian day (format jjj).
%%TIME Time of day (format hhmmss).
%%BLANK Resolves to one blank.
%%BLANKn Resolves to n blanks, where n is a number between 1 and 99.
%%JOBNAME Name of the decollation job. (Report decollating missions only.)
%%JOBID JES job number of the decollation job. (Decollations from spool only.)
a
Start of the week depends on an IOA installation parameter specifying whether 1 is Sunday
or 1 is Monday. See your INCONTROL administrator for your site standard.

The following AutoEdit System variables, prefixed by %%$, resolve to dates having
4-character years:

Table 291 AutoEdit System Variables - 4-character years

Variable Description
%%$DATE Current system date (format yyyymmdd).
%%$YEAR Current system year (format yyyy).
%%$ODATE Original scheduling date of the mission (format yyyymmdd).
%%$OYEAR Original scheduling year of the mission (format yyyy).
%%$RDATE Current working date (format yyyymmdd).
%%$RYEAR Current working year (format yyyy).
%%$JULDAY Current system day (Julian format yyyyjjj).
%%$OJULDAY Original scheduling year and day of the mission (Julian format yyyyjjj).
%%$RJULDAY Current working day of the year (Julian format yyyyjjj).

The following AutoEdit System variables, prefixed by %%$, resolve to the first two
digits of the year in dates which have 4-character years:

848 CONTROL-D and CONTROL-V User Guide

 System Variables

Table 292 AutoEdit System Variables - 2-character years

Variable Description
%%$CENT First two digits of the year in the current system date (for example, 20 in
2000).
%%$OCENT First two digits of the year for the missions original scheduling date.
%%$RCENT First two digits of the current working year.

Appendix B Shout Facility Variables 849

System Variables

850 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Index
Symbols
! Character, Hex Value 82 %%DATE System Variable 847
# Character, DO INDEX Statement 467 %%DAY System Variable 848
# OF DAYS TO KEEP %%DDNAME Function
Description 648 DO NAME Statement 486
Example 649 DO REMARK Statement 497
Migration Missions 164 DO USER Statement 518
Summary 647 %%DSNLLQ Function DO NAME Statement 486
# OF GENERATIONS TO KEEP %%EWTR 573
Backup Missions 164 DEST parameter 573
Description 650 %%EXTWTR Function
Example 651 DO NAME Statement 485
Summary 647 DO REMARK Statement 496
$ Character, Hex Value 82 DO USER Statement 516
$$$$ Date Reference %%FILE Function
DO COND Statement 455 DO NAME Statement 486
IN Parameter 529, 680 DO REMARK Statement 497
OUT Parameter 579 %%JOBID System Variable 848
Schedule Date 455, 528, 579, 679, 703 %%JOBNAME Function
Why Screen Confirmation Window 314 DO COND Statement 457
$$$SPACE Member 117, 149 DO NAME Statement 485
$$CTDSAT Member DO REMARK Statement 496
External Destinations Screen 291 DO USER Statement 517
$$FRM Member, IOA MSG Library 187 OUT Parameter 581
$* Value, EXTWTR Parameter 517 %%JOBNAME Variable System Variable 848
$JOBCHK Ruler, MSGCLASS Output 276 %%JULDAY
$LSYS Command, Machine ID Under JES2 511, 602, 727 Julian Day 848
$PROFVAR Member, SOLVLVC Profile Variable 250 System Variable 848
$SYSDATA Parameter, Recipient Tree 177, 794 %%MONTH System Variable 848
$SYSDATA Record %%ODATE
Active Report List 764 Date of the Job 848
Long Format 282, 284 System Variable 847
Migrated Report 284 %%ODAY System Variable 847
Options 285 %%OJULDAY
Predecollation Reports 279 Julian Day of the Job 848
Short Format 281 System Variable 847
Viewing 280, 285 %%OMONTH System Variable 847
$SYSDATA Records %%OWDAY System Variable 847
Additional Info Option 284 %%OYEAR System Variable 847
$USRNO Installation Parameter 187 %%OYEAR Year of the Job 848
$USRYES Installation Parameter 187 %%RDATE
% Character SHOUT Parameter 600, 725 System Variable 847
%%BLANK System Variable 848 Working Date 848
%%BLANKn System Variable 848 %%RDAY System Variable 847
%%CONTNAME Function DO NAME Statement 487 %%RJULDAY System Variable 847
%%DATE System Date 848 %%RMONTH System Variable 847
%%RWDAY System Variable 847

Index 851
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

%%RYEAR System Variable 847 Printing Mission Name 493

%%RYEAR Working Year 848 *FORCE Option
%%TIME System Variable 848 DO USER Statement 516, 800
%%USERID Function Recipient Tree 799
DO NAME Statement 485 *P Field
DO REMARK Statement 497 Conditions/Resources 368
DO USER Statement 517 *SPOOL
%%VAR DEST Field 833
CAPS Command 122 ON STATEMENT DEFAULTS 573, 575
%%WDAY System Variable 848 Print Destination 537
%%YEAR System Variable 847 *SPOOL Value
%%YEAR System Year 848 ON STATEMENT DEFAULTS 537
%DSR_NAME% *T Command
CTDDS ATTRIBUTES 291 JES Name 510, 601, 726
%EMAIL% + Sign
CTDDS ATTRIBUTE 291 Change Resource Window 374
%FAX% DAYS Parameter 440, 666
CTDDS ATTRIBUTES 291 DO COND Statement 455
%FOLDER% DO INDEX Statement 465
CTDDS ATTRIBUTES 291 OUT Parameter 579, 703
%JOBNAME% SHOUT Parameter 600, 725
CTDDS ATTRIBUTES 291 WDAYS Parameter 748
%MAIL_HOST% - Sign
CTDDS ATTRIBUTE 291 Change Resource Window 374
%ODATE% DAYS Parameter 440, 666
CTDDS ATTRIBUTES 291 DO COND Statement 455
%REMARK% DO INDEX Statement 465
CTDDS ATTRIBUTES 291 OUT Parameter 579, 703
%REPORT% SHOUT Parameter 600, 725
CTDDS ATTRIBUTE 291 WDAYS Parameter 748
' Character .GE. Operator 268, 622, 625
FIND Command 96 .GL. Operator 622, 625
( Character .GT. Operator 192, 268, 622, 625
Hex Value 82 .LE. Operator 268, 622, 625
* Character .LT. Operator 268, 622, 625
CATEGORY Parameter 431 .NE. Operator 268, 622, 625
CONFCAL Parameter 611 < Character CONFCAL Shift 433, 659
DO INDEX Statement 467 < Character DAYS Parameter 440, 666
DO NAME Statement 484 < Character Print Control 325
DO REMARK Statement 495 < Character SHOUT Parameter 600, 725
DO USER Statement 513 < Character Stop at Report 324
JOBID Parameter 544 < Character WDAYS Parameter 748
Prefixing 84 = Option Code
PRIORITY Parameter 592, 715 Multi-screen Control 90
Quick Access Panel 228 =1 Command
Report Decollating Utility 409 Primary Option Menu 87, 88
SPAGE Command 251 =6 Command
Values of Index Panel 825 PF06/PF18 108
WCAL Parameter 611 =X Command
WHEN Statement 621 Fast Exit 91
**** Date Reference Online Facility Exit 91
DO COND Statement 455 Report Viewing 249
IN Parameter 529, 680 User Report Lists 223
OUT Parameter 579 > Character
Schedule Date 455, 579, 679, 703 Condition Codes 192
Why Screen Confirmation Window 314 CONFCAL Shift 433, 659
*DEFAULT DAYS Parameter 440, 666

852 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Print Control 326 Example 304

SHOUT Parameter 600, 725 Fields 306
Skip to Report 324 Log Option 315
WDAYS Parameter 748 Mission Status 305
? Character Options 311
DO INDEX Statement 467 PFKeys 309
@ Character RERUN Option 321
DO INDEX Statement 467 SHOW Command 309
Hex Value 82 SHOW Option 304
| Character Why Option 312
Hex Value 82 Zoom Option 316
Active Report List
$SYSDATA Long Format 282
Numerics $SYSDATA Short Format 280
All Fields Display Type 214, 218
1 Command Bypass Panel Parameter 194
Primary Option Menu 87, 88 Default Display Type 201
33day Default Description 198
Periodic Calendar 666 DEST Field 832
3490 Emulation Edit Command 256
CART Media 787 Job Display Type 209
OSS Media 786 Long Display Type 212
35-Day Default Option V 246
Periodic Calendar 401 Printing Mission Name 831
Quick Access Display Type 226
REMARK/CCs Field 495
A Report Entry 764
RULER Command 275
A Line Edit Command 838 SDSF Display Type 210
Abend Code SEARCH Parameter 519
MSGCLASS Output 192 Selected Pages Print Option Window 252
SB37 757 SHOW Command 223
ACB/DCB Parameter User Display Type 205, 207
CDAM Logic 776 User Entry 764
ACCOUNT Parameter V Option 246
$SYSDATA Long Format 283 Active Transfer File
Account Summary Format Description 48
Index Pages 67 File Transfer Control 294
ACF2 708 Packet Parameters 302
ACIF Environment Add Background Image parameter 342
STORE Parameter 737 ADD Command
ACIF Parameter Conditions and/or Resources 370
$SYSDATA Long Format 283 Add Condition Option
STORE Parameter 764 Why Screen 313
Activating ADD Condition Window
relevant device or function 759 Conditions/Resources 371
Active Missions File ADD CONTROL Command
Basic Scheduling 125 Conditions and/or Resources 371
Date 719 ADD INFO Option
Description 48 External Destinations Screen 289
Emergency Mission 687 User Report Lists 222
MAXWAIT Parameter 548, 686 Add Line Feed parameter 350
ODATE 423, 642 ADD Option
PRIORITY Parameter 592, 715 Manual Conditions 378
TASKTYPE Parameter 605 ADD RESOURCE Command
Active Missions Screen Conditions and/or Resources 371
Commands 306 ADDED Field

Index 853
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Manual Conditions 375, 376 Active Missions File 48

Adding AMNAME Installation Parameter 760
Conditions and/or Resources 370 AMPREF Installation Parameter 771
Prerequisite Condition 313 AMPREFD Installation Parameter 771, 776, 778
Additional Info Option AMUNIT Installation Parameter
$SYSDATA Records 282, 286 CDAM 772
All Fields Display Type 217 PRINT/CDAM PARMS 589
Job Display Type 210 AMVOL Installation Parameter
Report Lists 200 CDAM 772
SDSF Display Type 212 AND/OR Logic
Additional Users Field DAYS Parameter 439, 665
User Report List 204, 208, 217, 236 WDAYS Parameter 747
ADDRESS Parameter WHEN Statement 131, 621
Recipient Tree 177, 794 AND/OR Parameter
AFP DAYS Parameter 159, 611, 665
Column > 998 624 WDAYS Parameter 159, 611, 747
OUTPUT Parameter 762 WHEN Statement 515, 621
PRINT/CDAM PARMS 588 APA Parameter
Report Clique parameters 346 $SYSDATA Long Format 283
Afp Formdef Name parameter 346 AFPDS Report 766
AFP Input Type parameter 346 CDAM 766
Afp Pagedef Name parameter 346 Application Server
AFP Report CONTROL-D/WebAccess Server 53
STORE Parameter 737 Apply on Header Field
AFP Reports Color Lines Screen 272
CONTROL-D Report Clique Screen 334 Include Lines Screen 268
AFPDS Report Archive Server
APA Parameter 766 CART Media 787
ASSOC Parameter 766 DASD Migration 785
STORE Parameter 737 Description 785
TRANSTO Parameter 772 Features 52
AGE Parameter FTK Media 786
Migration Type 734 IOASPRM Member 785
REFRESH EVERY Parameter 735 OSS Media 786
STAGE Parameter 733 ARCS Format 61, 63
Summary 164 ARG Parameter
Alias Field DO CTBRULE 459
Recipient Tree 793 ASA Control Characters
All Fields Display Type PRINT/CDAM PARMS 590
$SYSDATA Records 282 Translation 765
Additional Info Option 217 ASCENDING Sort Order
Fields 216 SORT Parameter 730
User Report Lists 214 ASIS Value
Allocation Algorithm CATEGORY Parameter 655
CDAM 775, 777 ASK FOR EACH ONE Field
ALLOCOPT Parameter Confirmation Window 138, 169, 373
CDAM 764, 765, 778 Manual Conditions Confirmation 379
CTDAMUTI Utility 784 ASM2 Format 61, 63
DDNAMES Index 470 ASSOC Parameter
DSN Parameter 522 AFPDS Report 766
JOBSDSN1 Option 281 ATF
ONEDSN Option 281 Active Transfer File 48
PRINT/CDAM PARMS 589 AUTHORIZE Field
ALOPT Parameter Recipient Tree 804
$SYSDATA Long Format 283 AUTHORIZE Parameter
AMBLOCK Installation Parameter 777 Recipient Tree 177, 794
AMF AutoEdit Facility

854 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

CONTROL-M 774 Migration Mission 642

AUTOEDIT SIMUL Option Mission Definition 159
Online Utilities Menu 407 Order Options 168
AutoEdit Variable Parameters 640, 642
DO SHOUT Statement 510, 601, 726 Batch
Shout Facility 847 Printing 61
Automation Log Screen BATCH Parameter
SHOW Command 381 Chunking 707
AUTOMATION OPTIONS Description 162, 652
IOA Menu 89 Summary 646
Batch Printing
Printing, Batch 162
B BEFORE Option
Edit Report Screen 256
B Line Edit Command 838 BKP Value
Backed Up Status TASKTYPE Parameter 738
User Report Lists 219 BLKSZ Parameter
Background Color $SYSDATA Long Format 283
parameter 344 BLOCKS Parameter
Background Image Url parameter 344 CDAM 767, 778
BACKUP IN PROCESS Status BMC Software, contacting 2
Active Missions Screen 309 Boolean Logic
Backup Mission Comparison Operators 192, 268, 625
# OF GENERATIONS TO KEEP 164, 650 DAYS Parameter 439, 665
Active Missions File 317 WDAYS Parameter 747
CATEGORY Parameter 654 WHEN Statement 131
DO BACKUP Statement 132, 452 Branch Summary Format
Editing 165 Index Pages 66
Example 649, 696, 708, 720, 741 Browse Mode
Mission Name 452, 691 Category List 117, 149, 150
Parameters 153, 163, 641 Job List 116
Scheduling Utility 411 Mission List 148
Screen 156 Recipient Tree 172, 175
TASKTYPE Parameter 738 BROWSE Option
Workflow 61 Calendar List Screen 394
Zoom Screen 317 Job List Screen 110
Backup Mission field Migration, Printing, Backup, Restore Mission List
$SYSDATA Long Format 282 Screen 142
BACKUP Parameter BUILDING PRINT PLAN Status
STORE Parameter 161, 736 Active Missions Screen 308
Backup Utility Bundle
ISPF (Online) 411 Destination 832
Backup Volumes field Logical Requirements 828
$SYSDATA Long Format 282 Organization 826
Balancing Operation Printers Control Monitor 47
DO CTBRULE 133, 459 Printing Sequence 830
Balancing Operations Sorting 827
CONTROL-M/Analyzer 57 BUNDLE INDEX Field
BALANCING STATUS Option Recipient Tree 794
Primary Option Menu 89 Bundling Parameters
BANNER Field Description 639, 641
Recipient Tree 794 Printing Mission 158
Banner Printing SORT Parameter 729
CATEGORY Parameter 655 BURST Parameter 760
Basic Scheduling Bypass Chunking
Decollating Mission 125, 137, 421 PRINTER Parameter 713
FORCE Option 168 BYPASS PANEL Field

Index 855
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Direct Online Viewing 186 Command 122

Quick Access Panel 194 CAPS Command
RETURN Command 226 %%VAR 122
User Reports Entry Panel 190, 194, 825 DO INDEX 122
DO NAME 122
DO REMARK 122
C DO SET 122
MASK 122
C PRINT/CDAM ARMS 122
Category Option Category List Screen, Migration, SET 122
Printing, Backup, Restore Mission Definition 152 STRING 122
Category Option Category List Screen, Report Variable Zoom screen 383
Decollating Mission Definition 120 WHEN LINE 122
C Option WHEN VAR 122
Year List Screen 396 XMLSEP 122
Calendar CART Media
CONFCAL Parameter 425, 644, 659 3490 Devices 787
DATES Parameter 662 Archive Server 787
Decollating Missions 424 Cartridge Migration
Example 442, 614, 668, 750 Wait Message 247
Periodic 441, 667, 749 CATEGORY Command
Scheduling Logic 644 Active Missions Screen 306
Calendar Definition Screen 394, 399 Log Screen 382
Exiting 404, 405 CATEGORY Field
Calendar Facility Active Missions Screen 307, 310
Accessing 391 Backup/Migration Utility 412
Deleting a Calendar 403 General Parameters 123
Entry Panel 392 Log Screen Filter 388
Exiting 404 Online Utilities 409, 410, 412, 413
General 390 Printing Mission Utility 410
Inserting a New Year 397 Report Decollating Utility 409
Periodic Calendar 73, 400, 441, 613, 666, 749 Restore Mission Utility 413
Summary 72 User Report Lists 204, 208
CALENDAR Field Category Field
Calendar Facility Entry Panel 393 User Report Lists 216
CALENDAR LIBRARY Field Category List
Backup/Migration Utility 412 DESC Parameter 674
Printing Mission Utility 411 Example 117, 149, 150
Report Decollating Utility 409 Exit Option Window 135, 166
Restore Mission Utility 414 Options 137, 168
Calendar List Screen 393 Category List Exit Window
Exiting 407 Member Creation 109
Calendar Periodic Mission Creation 141
Description 400 Category List Screen
CANCEL Command COPY Option 111, 142
Calendar Definition Screen 405 Migration, Printing, Backup, Restore Mission
Column Editing 266 Definition facility 141
Decollating Mission 134 Report Decollating Mission Definition Facility 109
Description 98 Category List Screen, Migration Printing, Backup, Restore
Mission Definition 166, 167, 353 Mission Definition
Recipient Tree List 179 Force 152
Report Decollating Mission Definition Entry Panel 113 Category List Screen, Migration, Printing, Backup, Restore
Zoom Screen 321 Mission
CANCEL Mission Definition Entry Panel 145 Ordering Multiple Missions 143
CANCEL Option Category List Screen, Migration, Printing, Backup, Restore
History Report List 241 Mission Definition
CAPS Delete 151

856 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Force 152 PRINT DD Statement 759

Format 150 Problem Determination 768
Insert 151 Suppression 779
Options 151 Sysout Control 760
Category List Screen, Printing, Backup, Restore Mission Workflow 758, 775
Definition CDAM Dataset
Commands 151 %%JOBNAME Variable 457
Category List Screen, Report Decollating Mission Deleting 781
Definition Migrated 785
Delete 119 Multijob 777
Force 120 Naming Convention 776, 785
Insert 119 ODATE Option 774
Category List Screen, Report Decollating Mission Space Allocation 775
Definition Facility CDAM field
Commands 119 $SYSDATA Long Format 282
Format 118 CDAM File
Category List, Report Decollating Mission Definition $SYSDATA Records 285
Facility CTDAMUTI Utility 782
Options 119 CTVCLMIG Utility 718
CATEGORY Parameter Decollation 806
Description 431, 654 DO INDEX Statement 68, 468
Example 431, 655 Packet Zoom Screen 302
Printing Mission 829 Relative Byte Address 218
Show Options Window 193 Retrieval by Index Value 67
Show Screen Filter 388 Sequence Number 218
Sort Key 729 STORE Parameter 737
Summary 157 CDAM Files
CB Line Edit Command 837 Archive Server 785
CC Line Edit Command 837 Migrated 285
CCs Parameter CDAM Name Field
User Reports Entry Panel 197 Migration Log 285
CD message type CDAM Parameters
Selection Criteria 387 ALLOCOPT 589
CDAM ASSOC Parameter 766
Activating 759 BLOB Parameter 766
ALLOCOPT Parameter 589, 778 Description 586, 760, 767
Benefits 757 DEST 833
Compression 758, 768, 781 DSN 522
Control Parameters 763 FORMDEF 589
CTDAMUTI Utility 778, 781 LINECT 590
CTDX018 Exit 769, 779 Overriding 589
Decollating 522 PAGEDEF 589
Decollation 806 TRANSTO Parameter 772
Decompression 757, 767, 781 CDAM Server
Description 756 Archive Server 785
DEST Parameter 575 CDAMSNAP DD Statement
DSN Parameter 522, 773 DEBUG Parameter 768
ENCODING Parameter 769 CDAMFILE NAME
JES Dataset 764 User Report Lists 218
Logic 775 CHANGE Option
Maintenance Utility 781 Conditions/Resources 373
Multijob Datasets 777 Character
MVS Environment 773 Hex Value 82
ON DSN Statement 770, 774 Character Comparison
OPTCD Parameter 760 String Operators 268
Parameters 575, 760, 778 Character Set Translation
Prefixes 778 CTDX007 Exit 626

Index 857
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Character String CLEAR Command

Prefixing and Masking 83 Notepad Facility 244
Characters, Special CLEAR Ruler Option
Hexadecimal Values 82 Exit Option Window 274
CHARS Clique Resources
Sort Key 730 CONTROL-D Objects Facility 360
Chars Field CLIST
User Report List 208 CTDMISRQ 409, 410, 412, 413
CHARS Parameter TSO Screen 106
$SYSDATA Long Format 217, 283 CLIST IOAUTIL
CDAM 760 Online Utilities 407
CHECK Field CLS Parameter
Recipient Tree Exit 178 Description 628
Check In External Volume Option Example 630
Primary Option Menu 89 CMEM Definition Option
Check/Sort Primary Option Menu 89
Recipient Tree 178 CMPEXT 767, 773
Child Field CMPRTN Parameter
Report List Header 200 CDAM 768
CHILD Parameter CODE Criteria
Show Options Window 192, 200 IOA Log Show Screen Window 388
CHKTREE Command Screen Filter 388
Recipient Tree 172, 175 CODE Field
CHKUSR Command Log Screen 380
Decollating Mission 135 Code of input AFP parameter 347
Chunking Code Page parameter 344
BATCH Parameter 652 COL Parameter
CATEGORY Parameter 655 DO INDEX Statement 466
JES Outgroup 707 DO NAME Statement 484
OVERRIDE Parameter 707 DO REMARK Statement 495
CHUNKSIZE Parameter DO SET Statement 502
PRINTER Parameter 712 DO USER Statement 514
Spool Printing 161 WHEN Statement 620
CICS 81, 247 COLOR Code
Environment 50 Color Lines Screen 272
CICS Dumps Color Code
CDAM Datasets 773 Color Lines Based on Strings 272
CICS Environment 81 Include Lines Screen 269
CICS Generated Files Mission Status 305
WHEN IN QUEUE Parameter 629 Color Columns
CL Line Edit Command 837 Edit Report Columns 262
CLASS Field Tagged Substrings 277
Confirm Print Window 300 Color Definitions
Packet Index Screen 303 Report Viewing 246
Class Field Color Lines Based on Strings
User Report Lists 202, 204, 206, 208, 211, 216 Apply on Header Field 272
CLASS ON Statement COLOR Code 272
ON CLASS Statement 560 Description 270
CLASS Option Example 272
ON Statement 129, 560 HILITE Code 272
CLASS Parameter Report Editing 255
ON SYSOUT Statement 562 String/Line/Column Flag 272
OVERRIDE Parameter 706 Color parameter 342
Print Option Window 239 Color Support
Summary 162 Extended 7Color 50
CLEANUP Option IOA Screens 82
Online Utilities Menu 407 Online Viewing 82

858 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Column Editing Log Screen 381

Rulers 261, 265 Move 837
Column Range NEW 244
Include Lines Screen 267 NEW COND 376
COLUMNS Option NEXT 93, 175, 227, 230, 244
Edit Report Screen 256 NEXTCTG 135, 166
COM-PLETE 81 NEXTPAGE 248
Environment 50 Online Facility 92
Command =1 PATH 124
Primary Option Menu 87, 88 PREV 93, 227, 230, 244
Command 1 PREVCTG 135, 166
Primary Option Menu 87, 88 PREVPAGE 248
Command Line PRINT 100
Online Facility 92 Quick Access Panel 230
PFKey Interaction 94 Recipient Tree 175
Command line commands REFRESH 223
IOA Editor 102 Report List 223
Commands Report Viewing 248
=1 87, 88 RESET 93, 98, 134, 136, 165, 179, 264, 390
=6 107 RETRIEVE 93
1 87, 88 RETURN 93, 191, 194, 226
Active Missions Screen 306 RETURN to Entry Panel 194, 223
ADD COND 371 Return to Entry Panel 194
ADD CONTROL 371 RIGHT 93, 248
ADD RESOURCE 371 RULER 223, 275
ADD Resources 370 Ruler Show Mode 223
CANCEL 98, 113, 136, 145, 167, 353 SAVE 244, 302, 321, 353
CAPS 122 SCHED 123, 125, 153
CHKTREE 172, 175 Scrolling 95
CHKUSR 135 SELECT 109, 141
CLEAR 244 Select Pages 250
Conditions/Resources Screen 371 SET 104
Copy to File 94 SHOW 191, 223, 299, 309, 384
CTMTTRA 107 SHOWCC 249
DELETE 244 SHOWNOTE 278
DESC 119, 151, 306, 396 SHOWPAGE 249
DISPLAY 187, 223 SHPF 93, 230
DOWN 93, 95, 228 SORT 224
EDIT 133, 165, 249, 255, 835 SPAGE 250
Editing 837 SPLIT 100
END 93, 99, 134, 166, 226, 230, 244, 248, 252, 266, 353, STAT 119, 151, 396
390 SWAP 100
Exit Online Facility 91 TSO 107
File Transfer 299 TSO CTMTTRA 107
FIND 93, 96, 223, 233, 248 TSO SEND 510
GROUP 306, 382 Undelete 327
HELP 93, 98 UP 93, 95, 228
HEX 249 UPDATE 222, 244, 286
Index Window 234 User Reports 223
ISPF 99 VALUE 249
KEYS 100 Values of Index Panel 233
L Parameter Prefix 99 WRAP 250
LEFT 93, 248 Comparison Operators
Line Editing 837 String Comparison 267
LOCATE 95 STRING Field 622, 625
Location 838 Comparison String
LOCNOTE 278 Color Lines Screen 271

Index 859
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Include Lines Screen 267 Manual Conditions 379

Masking and Prefixing 267 Confirm Override Window
Components Print Plan Screen 325, 327
CONTROL-V 46 CONFIRM Parameter
Compression Confirm Print Window 300
CDAM 758, 768, 781 Confirm Print Window
Computer Downtime File Transfer Control 300
RETRO Parameter 594, 719 Confirmation Indicator
CompuView Navigator Notepad Window 245
STORE Parameter 737 Confirmation Window
COMPLETE 81 Category List 138, 168
CONCAT Parameter Delete Conditions/Resources 372
DO USER Statement 515 Job List 117, 137
Concatenation Manual Conditions 378
DO REMARK Statement 498 Mission List 149, 168
Report Name 487 Reprint Rerun 322
WHEN Statement 621 SUSRDELW Profile Variable 222
COND NAME Parameter Why Screen 314
Active Missions Screen 311 Zoom Screen 320
Condition Codes Continuous Identification
Show Options Window 192 CONTID Parameter 131
CONDITION DATE Field WHEN Statement 621
Prerequisite Condition Utility 416 Continuous Index
CONDITION Field Index 467
Manual Conditions 375 Continuous Record Level
CONDITION NAME Field Index Type 65
Prerequisite Condition Utility 416 Continuous Record Level Index
CONDITION/RESOURCE Field Index, Record Level 68
Conditions/Resources 367 Control Characters
Conditions File Page Control 249, 590, 770
Overview 48 Translation 765
CONDITIONS Parameter CONTROL Parameter
Conditions/Resources 369 Conditions/Resources 369
Conditions/Resources CONTROL Resource
Add/Check/Delete Utility 415 Adding 370
Delete Option 372 Manual Addition 371
Manual Conditions 377 CONTROL Resources
Options 371 CONTROL-M Resources File 366
CONFCAL Calendar IOA Conditions/Resources Screen 366
Scheduling Exception 434 CONTROL-D
CONFCAL Parameter Features 44
Decollating Missions 425 Integration 44
Description 434, 644, 659 Objects Facility 328
Example 434, 660 CONTROL-D Application Server
MINIMUM Parameter 552, 689 Page On Demand 53
PDS Parameter 584, 710 CONTROL-D Clique Resources Entry Panel 360
Periodic Calendar 434 CONTROL-D OUTPUT Statement
Schedule Confirmation 126, 159 PRINT/CDAM PARMS 589
SHIFT Parameter 644, 659 CONTROL-D Printer
SHIFT Values 434 Print Plan Screen 322
CONFIRM COPY Field CONTROL-D Procedure
External Destinations Confirmation Window 292 TREE Parameter 172
CONFIRM DELETE Field Tree Parameter 171, 328
External Destinations Confirmation Window 294 CONTROL-D Report Clique
CONFIRM Field Definition Screen 332
Conditions/Resources 372 CONTROL-D Report Clique Definition Screen
Give To Window 237 Exiting 353

860 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

CONTROL-D Report Clique Screen CONTROL-O

AFP Reports 334 Product Description 42
PDF Reports 337 CONTROL-O/COSMOS
Text Reports 332 Product Description 42
XRX Reports 336 CONTROL-V
CONTROL-D Reports Cliques Entry Panel 329 Capabilities 43
CONTROL-D Reports Cliques List Components 46
Options 331 Implementation 431
CONTROL-D Reports Cliques List screen 330 Overview 42
CONTROL-D Resouces List screen 359 Product Integration 44
CONTROL-D Resource Manager Repository 47
transformation of binary reports 809 Schematic View 42
CONTROL-D Resource Sets Entry Panel 354 CONTROL-V Monitor
CONTROL-D Resource Sets List Overview 46
Options 356 Status 306
CONTROL-D Resource Sets List screen 355 CONTROL-D/Image
CONTROL-D Resources Entry Panel 358 Product Description 42
CONTROL-D Resources List CONTROL-M
Options 357, 359, 362 Product Description 41
CONTROL-D Resources List screen 356, 361 CONTROL-V
CONTROL-D WF and Subscribe Entry Panel 363 Product Description 42
CONTROL-D/Image CONTROL-D for Distributed Systems 286
BLOB Parameter 766 Description 286
CONTROL-D/Page On Demand External Destinations Screen 287
Notes, Access to 241 Report Distribution 239
STORE Parameter 737 CONTROL-M/Enterprise Manager
CONTROL-D/PC SHOUT Parameter 600, 725
Dest/Udest Field 202, 206 CONTROL-D
File Transfer 294 Product Description 42
Workflow 296 CONTROL-D/Page On Demand
CONTROL-D/WebAccess Server Product Description 42
Active Transfer File 48 CONTROL-M/Tape
Application Server 53 Product Description 42
Dest/Udest Field 208, 212, 217 CONTROL-M/Restart
File Transfer 52 Product Description 41
Recipient Tree 50, 794 Conventions Used in This Guide 34
User Report Lists 204 CONVERT TO ASCII
Viewing a normalized report with 812 External Destinations Screen 290
CONTROL-M COP Field
AutoEdit Facility 774 Report Lists 206
Backup Mission Control 62 COP# Parameter
Date Force Option 774 Active Reports List 574
Prerequisite Conditions 71 MAXCOPIES Parameter 575
Restore Mission 63 COPIES Field
CONTROL-M Resources Confirm Print Window 300
File 366 Packet Index Screen 303
CONTROL-M Resources File 366 COPIES Parameter
CONTROL-M/Analyzer Description 534
Balancing Operations 57 Example 535
DO CTBRULE 133, 459 Packet Zoom Screen 302
DO REMARK 460 Print Option Window 239
DO TERMINAT NOTOK 460 Sysout Control 762
Integration 45 Copy
CONTROL-M/Analyzer Category in Category List Screen, Migration, Printing,
Product Description 42 Backup, Restore Mission Definition Screen 152
CONTROL-M/Restart SIMUL Option Category in Category List Screen, Report Decollating
Online Utilities Menu 407 Mission Definition Screen 120

Index 861
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

COPY command COPY Option 782

Copying Report Decollating Mission Definition to Example 783
another member 138 Multijob Datasets 784
Mission definition to another member (mission) 169 UTICOPY DD Statement 782
Copy Commands CTDCLHIS Utility
Edit Environment 837 # OF DAYS TO KEEP 648
Copy Confirmation Window # OF GENERATIONS TO KEEP 650
External Destinations Screen 292 CTDDELRP Utility
COPY Count Deleting User Records 286
ON STATEMENT DEFAULTS 576 Report Deletion 59
Copy Count CTDDS ATTRIBUTES
COPIES Parameter 534 %DSR_NAME% 291
MAX COPIES Parameter 540 %EMAIL% 291
User Report Lists 202, 204, 206, 216 %FAX% 291
COPY Option %FOLDER% 291
Category List Screen 111 %JOBNAME% 291
Category List Screen, Migration, Printing, Backup, %MAIL_HOST% 291
Restore Mission 142 %ODATE% 291
CTDAMUTI Utility 782 %REMARK% 291
External Destinations Screen 289 %REPORT% 291
Year List 396 %REPORT-ID% 291
COPY Option Category List Screen, Migration, Printing, External Destinations Screen 291
Backup, Restore Mission Definition 152 Fields 291
COPY Option Category List Screen, Report Decollating CTDMISRQ CLIST
Mission Definition 120 MIS(BKP) Parameter 412
COPY TO DEST Field MIS(PRT) Parameter 410
External Destinations Confirmation Window 292 MIS(REP) Parameter 409
COSMOS Status Option MIS(RST) Parameter 413
Primary Option Menu 89 CTDMON# Parameter
COUNT Parameter Parallel Decollating 554
Change Resource Window 373 CTDPARM Member
CPR Value PARM Library 792
TASKTYPE Parameter 738 CTDPC Destination
CPU ID File Transfer 294
Version Information Window 90 Unidentified Pages 536, 573
CREATE Option CTDPCPRT Destination
Recipient Tree 178 File Transfer 295
CREATED Date and Time Unidentified Pages 536, 573
File Transfer Control 297 CTDPRINT Procedure
Packet Zoom Screen 301 TREE Parameter 172
Creating a decollation mission with a Report Clique 811 Tree Parameter 171, 328
Creating a text report 813 CTDS Value
Creating Members External Destination 286
Report Decollation Mission Facility 109 External Destinations Screen 287
Creation Date field CTDSE04 Security Module
$SYSDATA Long Format 283 Recipient Tree Bypass 804
Cross Memory Services CTDSECP Member
Archive Server 785 SECSRC Library 804
Online Monitor Address Space 81 CTDUPBKP Utility
CRS Value # OF DAYS TO KEEP 649
TASKTYPE Parameter 739 # OF GENERATIONS TO KEEP 651
CRSR Migrated Files 734
Scrolling Amount 95 CTDX004 User Exit
CS Line Edit Command 837 Recipient Tree Bypass 805
CTDAMUTI Utility CTDX004U User Exit
CDAM Maintenance 781 SAMPEXIT Library 805
CDAM Prefixes 778 CTDX007 Exit

862 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Character Set Translation 626 D3 ISPF Utility

WHEN Statement 626 Backup Mission Scheduling 408
CTDX016 Exit Migration Mission Scheduling 408
DO USER Statement 515 D3 Option
Recipient Tree 800 Online Utilities Menu 411
CTDX018 Exit D4 ISPF Utility
CDAM 769, 779 Restore Mission Scheduling 408
CTDX018O Member D4 Option
SAMPEXIT Library 780 Online Utilities Menu 413
CTDX018S Exit DAGENUSR Library
Report Splitting 781 Generic Recipients 516
SAMPEXIT Library 781 DAILY Category
CTDX020 Exit CONTROL-V Implementation 431
Sort Code E 730 Example 431
CTVCLMIG Utility Daily Subsystem
# OF DAYS TO KEEP 648 New Day Procedure 51
RETENTION DAYS 718 DASD Target
CTVJAR Utility Migration 785
Main Index Format 470 DASD Value
CTVPARM Member MEDIA NAME Parameter 734
IOA PARM Library 822 DASDResident
CTVPARM member 822 Index 69
customer support 2 DASDresident
Customizing Report Access 59
Online Facility 80 Data Area of Screen
Cut and Paste Online Facility 92
Line Range 264 DATE 824
Rulers 256 DATE Decollated
Cut Columns Packet Index Screen 303
Edit Report Columns 262 Date Definition
Cyclic Interval Types of Dates 73
Migration 733 DATE Designation
Cyclic Mission CDAM 773
Generic Decollating 524 DATE Field
INTERVAL Parameter 127, 160, 317, 532, 684 Conditions/Resources 367
Restore Mission 532 Index File Name 823
TASKTYPE Parameter 604, 738 Log Screen 380
WAIT SCHEDULE Status 739 Manual Conditions 375
Quick Access Panel 229
Date Force Option
D CDAM Datasets 774
CONTROL-M 774
D DATE FROM/TO Parameter
Category Option Category List Screen, Migration, User Reports Entry Panel 189
Printing, Backup, Restore Mission Definition 151 DATE FROM=LAST
Category Option Category List Screen, Report User Reports Entry Panel 188
Decollating Mission Definition 119 Date List
D Line Edit Command 837 DATES Parameter 662
D1 ISPF Utility DATE Parameter
Report Decollating Mission Scheduling 408 CDAM 768
D1 Option DATE Range Field
Online Utilities Menu 409 Manual Conditions 376
D2 ISPF Utility Date Reference
Printing Mission Scheduling 408 DO COND Statement 455
D2 Option IN Parameter 528, 680
Online Utilities Menu 410 Prerequisite Condition 456, 580, 704
D2B601 295 Schedule Date 455, 528, 579, 679, 703

Index 863
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Why Screen 313 DEBUG parameter 352

Zoom Screen 317 Decollate by Line
Date Verification CTDX018 Exit 781
CONFCAL Calendar 434 Decollated Date and Time
CONFCAL Parameter 425, 659 User Report Lists 203, 208, 210, 212, 216
DATES Parameter DECOLLATED NOTOK Status
DAYS Parameter 442, 667 Active Missions Screen 307
Description 436, 662 User Report Lists 219
Example 437, 662 DECOLLATED OK Status
MINIMUM Parameter 552, 689 Active Missions Screen 307
MONTHS Parameter 556, 695 DECOLLATED Status
PDS Parameter 584, 710 Show Options Window 193
Summary 126 User Report Lists 219
DATES Range Field Decollating Criteria
Conditions/Resources 369 Category 431
Day of the Week Decollating Mission
First 746 Basic Scheduling 125, 423
WDAYS Parameter 126, 610, 746 CANCEL Command 136
DAYS Parameter CHKUSR Command 135
AND/OR Logic 439, 665 Criteria 431, 805
And/Or Logic 126 CTDX018 Exit 780
Boolean Logic 439 Editing 133, 835
DATES Parameter 436 Example 55, 123, 839
Decollating Missions 424 Exiting 134
Description 438, 644, 664 FORCE Option 137
Example 442, 668 General Parameters 124
Format 439, 665 Generic 524
Logic 441, 667 Nongeneric 524
MINIMUM Parameter 552, 689 ORDER Option 137
Negative Value 441, 667 Ordering 137
PDS Parameter 584, 710 Parameters 128, 427, 805
Summary 159 PATH Command 124
DB Line Edit Command 837 Postprocessing 128, 426
DB VARIABLE DEF Option PRINT/CDAM PARMS 762
Primary Option Menu 89 Printing Mission Name 831
DCAL Parameter PRIORITY Parameter 592
AND/OR Logic 439 Recipient Tree 795
Calendar Type 441, 667 Runtime Scheduling 127, 426
DATES Parameter 436 Saving Definitions 135
DAYS Parameter 159, 438, 439, 644, 664 SCHED Command 125
Decollating Missions 424 Scheduling Utility 408
DD Line Edit Command 837 Syntax Checking 135, 838
DD Statement TASKTYPE Parameter 604
DDNAMES Index 470 Workflow 56
DDNAME Field Zoom Screen 317, 320
$SYSDATA Short Format 281 Decollating Mission Order
DDNAME of JCL Statement CTDX018 Exit 780
Report Name Extraction 486, 497 Decollating Mission Parameters
DDNAME Parameter Description 54
CDAM 768 General 419, 426
ON SYSOUT Statement 562 Priority 592
DDNAMES Index Summary 422
DO INDEX Statement 463, 470 Decollating Mission Zoom Screen
Viewing 197 Confirmation Window 321
Debug Facility Decollating Parameters
CDAM 768 Decollating Missions 422
Debug File Name parameter 352 Description 427

864 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

DO Statements 131 Print Destination 536

JOB DEFAULTS 427 Default Ruler
Job Defaults 128 Report Editing 253
Mission Definition 128 Report Viewing 275
ON Statements 129 Default Sort Key
DECOLLATING Status SORT Parameter 729
Active Missions Screen 307 Default User
Decollating Utility JOB DEFAULTS USER Parameter 519
ISPF 408 DEFAULT USER Parameter
Decollation USER Parameter 542
From Compressed Datasets 806 Deferred Printing
From Spool 805 Print Option 238
Testing 806 Delete
using transformation 810 Category in Category List Screen, Migration, Printing,
Without Recipient Tree 51 Backup, Restore Mission Definition Screen 151
decollation Category in Category List Screen, Report Decollating
binary reports 807 Mission Definition Screen 119
print stream reports 808 Job in Job List 116
text reports 807 Job List 116
using transformation 808 Mission in the Mission List 148
Decollation Date and Time Notes 245
Active Report List 281 Prerequisite Condition 372, 456, 702
History Report List 281 Report 222
Decollation Date Field DELETE Command
User Reports Entry Panel 189 Notepad Facility 244
Decollation definition Notepad Window 245
Transformation using 816 Delete Command
Decompression Edit Environment 837
CDAM 757, 767, 781 Delete Commands
CTDAMUTI Utility 782 Edit Environment 837
Dedicated Devices Delete Confirmation
Archive Server 787 SUSRDELW Profile Variable 222
DEF DEST Field Delete Confirmation Window
Recipient Tree 834 External Destinations Screen 294
DEF DEST Parameter DELETE Option
Recipient Tree 177, 794, 832 Active Missions Screen 312
DEFAULT COPIES Parameter Calendar List Screen 394
COPIES Parameter 534 Category List Screen 111, 142
DEFAULT DEST Parameter Conditions/Resources 371
DEST Parameter 536 CTDAMUTI Utility 782
Default Display Type Edit Report Screen 256
Additional Info Option 202 External Destinations Screen 289
Fields 201 File Transfer Control 298
Note Field 242 Job List 116
User Report Lists 201 Job List Screen 111
DEFAULT Distribution Mission List Screen 142
DO USER Statement 514 Print Plan Screen 327
Default Filter Recipient Tree List 174
Log Screen 383 User Report Lists 222
DEFAULT LVL Parameter Year List Screen 396
LVL Parameter 538 Delete Option
Default Parameters $SYSDATA Records 286
COPIES Parameter 534 DELETE Option Category List Screen, Migration, Printing,
Decollating 128 Backup, Restore Mission Definition 151
MAX COPIES Parameter 540 DELETE Option Category List Screen, Report Decollating
ON STATEMENT DEFAULTS 572, 576 Mission Definition 119
Default Print Destination DELETED Field

Index 865
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Migration Log 285 User Report Lists 202, 204, 206, 208, 212, 217
DELETED Status Device Allocation
Active Missions Screen 307 Archive Server 787
File Transfer Control 297 CART Media 787
Deleting OSS Media 786
Calendars 403 DF/DSS Format 61, 63
Delete 254 DF/HSM Format 61, 63
Manual Conditions 378 Direct Online Viewing
Dependency Screen Flow 186
Prerequisite Condition 71 Display
DESC Command A (All Fields) 194
Active Missions Screen 306 Changing 187
Category List Screen, Printing, Backup, Restore Display A
Mission Definition 151 User Reports Entry Panel 187
Category List Screen, Report Decollating Mission DISPLAY Command
Definition Facility 119 IOA Log Screen 382
Year List Screen 396 Report Lists 223
DESC Field User Reports Entry Panel 187, 195, 198
Show Screen Filter Window 386 Display Filters Window
DESC Format Fields 385
Category List Screen, Migration, Printing, Backup, Options 385
Restore Mission Definition 150 Display J
DESC Parameter User Reports Entry Panel 187
Active Missions Screen 307 Display J (Job) 195
Description 448 DISPLAY OPTIONS
Example 448, 674 Show Options Window 193
Recipient Definition 177 DISPLAY OPTIONS Fields
Recipient Tree 793 User Reports Entry Panel 196
Summary 125, 158 Display Type
DESCENDING Sort Order 730 A (All Fields) 214
DESCRIPTION Field D (Default) 201
External Destinations Screen 289 J (Job) 186, 209
Recipient Tree List 174 L (Long) 212
Description Text Quick Access Report 226
DESC Parameter 674 Report List Header 200
DEST Field S (SDSF) 210
*SPOOL 833 U (User) 205
Active Report List 832 DISPLAY TYPE Parameter
Confirm Print Window 300 User Reports Entry Panel 190
External Destinations Screen 287 Display User Reports
Permanent Report List 832 Index Window 234
DEST Parameter Display V
CDAM 760 User Reports Entry Panel 187
Description 536 Distribution Address
Example 537 Recipient Tree 794
ON CLASS Statement 560 Distribution Type
ON STATEMENT DEFAULTS 573 TYPE Parameter 514
ON Statement Defaults 574 DJDE Parameters
Print Option Window 239 Xerox Printers 60
PRINTER Parameter 712 DL Line Edit Command 837
SUBSYS JCL Parameter 833 DMS/OS Format 61, 63
Summary 162, 318, 706 DO Action
DEST parameter 573 DO Statement 450
Dest/Wtr Field DO BACKUP Statement
User Report Lists 202, 206, 208, 212, 217 Description 132, 452
Destination Code Example 452
CTDS 286 Mission Name 691

866 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

DO COND Statement DO SET variables

Conflicts 457 used with DO statements 503
Definition 454, 704 DO SHOUT Statement
Description 132 Shout Facility 509
Example 458 Summary 132
Logic 455 DO Statement
OUT Parameter 457, 581 ON STATEMENT DEFAULTS Interaction 573
DO CTBRULE Statement DO Statements
Description 133, 459 Decollating Parameters 131, 428
Example 460 Description 450
DO INDEX DO BACKUP 132, 452
CAPS Command 122 DO COND 132, 454
DO INDEX Statement DO CTBRULE 133, 459
CDAM File 68 DO INDEX 462
DDNAMES Index 470 DO LEVEL 133, 480
Description 131, 462 DO MIGRATE 131, 481
Index Definition 65 DO NAME 132, 483
LINE Parameter 465 DO NOTOK 133, 490
REC Parameter 467 DO PRINT 132, 492
Subindexes 468 DO REMARK 133, 494, 500
VAR Parameter 466 DO SHOUT 132, 509
DO LEVEL Statement DO USER 131, 513
Description 133 Multiple 428
Recommendations 480 WHEN Statement 451
DO MIGRATE Statement DO statements
Description 131, 481 and DO SET variables 503
Mission Name 691 DO USER Statement
DO MIGRATION Statement Description 131, 513
Example 482 Example 519
DO NAME FORCE Option 516, 799
CAPS Command 122 DOCU/TEXT
DO NAME Statement Interface 408
Concatenation 487 Online Utilities Menu 407
Description 132, 483 Option 407
Example 485, 488 Option U1 408
DO NOTOK Statement Utility 408
Description 133, 490 DOLV
Example 490 Direct Online Viewing 186
DO PRINT Statement Dot Origin point parameter 353
Description 132, 492 Double Confirmation
Example 493 Job List 137
DO REMARK Mission List 168
CAPS Command 122 DOWN Command
DO REMARK Statement PF08/PF20 95
Concatenation 498 PFKey Definition 93
CONTROL-M/Analyzer 460 Quick Access Panel 228
Description 133, 494 DREPLST Parameter
Example 496 CTDSECP Member 804
Show Windows Option 192 DSN Field
DO SET CDAM DD Statement 773
and decollation subtasks 504 DSN ON Statement
CAPS Command 122 ON DSN Statement 560
Decollating parameter 132 DSN Parameter
placement 503 Description 522
used with WHEN 503 Example 522
DO SET Statement ON Statement 129
Description 500 DSNPREF Field

Index 867
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Index File Name 823 Edit Report Footer

DSNPREF Parameter FOOTER Option 256
Primary Migration 734 Edit Report Lines
DSNPREF parameter 823 Color Based on Strings 270
DUSERLST Parameter Description 254
CTDSECP Member 804 Example 255, 257, 260
Dynamic Destination Table Exclude Based on Strings 270
DO SHOUT Statement 511, 727 Include Based on Strings 266
SHOUT Parameter 610 Options 256
Dynamic Device Allocation SP CHAR Field 258
Device Allocation 787 Edit Rulers 222
Dynamic Extraction EDMEM command
Format 258 IOA Editor 101
Online Viewing 259 EMAIL Value
Overview 42 External Destinations Screen 289
Rulers 258, 260 Emergency Mission
MAXWAIT Period 687
TASKTYPE Parameter 604, 738
E EMG Value
TASKTYPE Parameter 738
E Option Emulation
Display Filters Window 385 3490 786
E/S Field ENCODING Parameter
Conditions/Resources 367 CDAM 769
EBK Value Encoding parameter 344
TASKTYPE Parameter 738 END Command
ECP Value Calendar Definition Screen 405
TASKTYPE Parameter 738 Column Editing 266
EDIT Command Decollating Mission 134
Decollating Mission 133, 165, 835 Help Screen 99
Report Viewing 249 IOA Log Show Screen Window 390
Edit Entry Panel Mission Definition 166, 353
IOA Editor 101 Notepad Facility 244
Edit Environment PFKey Definition 93
Commands 837 Quick Access Panel 226, 230
Description 133, 165, 835 Report Viewing 248, 252
Mission Definitions 133, 165, 835, 839 End TRACE level
Recommendations 838 SET Command Panel 104
Edit Mode ENDED NOTOK Status
Notepad Window 244 Active Missions Screen 307
Recipient Tree 172, 175 Color Codes 305
EDIT Option ENDED OK Status
Active Report List 222 Active Missions Screen 305, 310
Display Filters Window 385 ENDED OK NO REPORTS
Edit Report Columns Active Missions Screen 307
Coloring 263 ENDED OK WITH WARNINGS
Description 253, 254 Active Missions Screen 307
Example 261, 265 ENDED Status
Exiting 266 Active Missions Screen 310
Explanation 263 Ended Time Field
Freezing 262 User Report Lists 210
Highlighting 262, 263 ENTER Command
Line Range 264 Quick Access Panel 230
Option C 261 ENTER Key
Reformatting 261 Search Top Down 310
Resulting Line 262 ENTER SORT SEQ Field
Trigger 256 SORT Parameter 729

868 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

ENTER YES TO CONTINUE Field SHOUT Parameter 600, 725

Backup/Migration Utility 412 EXECUTING
Prerequisite Condition Utility 416 Mission Status 310
Printing Mission Utility 411 Execution Messages
Report Decollating Utility 409 ON Statement 561
Restore Mission Utility 414 Exit
Entry Number Field CTDX007 626
Migration Log 285 CTDX016 515, 800
Entry Panel CTDX018 769, 779
Calendar Facility 392 CTDX018O 779
CONTROL-D Clique Resources 360 CTDX020 730
CONTROL-D Report Cliques 329 EXIT Command
CONTROL-D Resource Sets Entry Panel 354 Primary Option Menu 87
CONTROL-D Resources 358 Exit Command
CONTROL-D WF and Subscribe 363 Online Facility 91
IOA 84 EXIT Option
Migration, Printing, Backup, Restore Mission Online Utilities Menu 407
Definition 141 Exit Option
Migration, Printing, Backup, Restore Mission Notepad Window 245
Definition Entry Panel 144 Print Option Window 238
Report Decollating Mission Definition Entry Panel 111 Exit Option Window
User Reports List 186 Category List 135, 166
ENTRY Parameter Global Rulers 276
$SYSDATA Long Format 283 Quick Ruler Definition Key 274
Environment Recipient Tree List 178
Edit 133, 165, 835 Report Editing Screen 273
ESA 773 RESET Command 179
EPR Value EXIT Parameter
TASKTYPE Parameter 738 CDAM 769, 779
EQ. Operator 622, 625 Exiting
ERASE Option CONTROL-D Report Clique Definition Screen 353
Manual Conditions 378 Decollating Mission 134
Erasing Edit Report Columns 266
Delete 455 IOA Log Show Screen Window 389
Error File Name parameter 352 Mission Definition 166
ERS Value Packet Zoom Screen 302
TASKTYPE Parameter 738 Recipient Definition 176
ESA Environment 773 Ruler Definition 265, 273
ESCAPCL Installation Parameter Zoom Screen 320
PRINT/CDAM PARMS 587 EXTENTS Field
Exclamation Mark Packet Zoom Screen 302
! Character 546 External Destination
EXCLUDE Argument Specifying 286
SPAGE Command 251 External Destinations Screen
Exclude Lines Based on Strings Additional Information 290
Report Editing 255, 270 CONTROL-D for Distributed Systems 287
EXCLUDE Statements Example 291
Printing Missions 829 Header Fields 288
EXCLUDE USER Parameter Options 289
Bundling Parameter 158 External Writer Flag
CATEGORY Parameter 654 User Report Lists 202, 204, 217
Description 682 External Writer Name
Example 683 %%EXTWTR Function 516
Printing Missions 654 External Writer Parameter
Exclusive Resource ON CLASS Statement 560
WAIT SCHEDULE Status 371 Print Option Window 239
EXECTIME Limit Extraction 42

Index 869
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

EXTWTR Mask User Report Lists 223

ON CLASS Parameter 485, 517 Values of Index Panel 233
EXTWTR Parameter FLASH Parameter
$* Value 517 $SYSDATA Long Format 283
ON CLASS Statement 560 CDAM 760
OVERRIDE Parameter 706 Laser Printers 826
Summary 162 FMDEF Parameter
$SYSDATA Long Format 217, 283
Font File Name parameter 350
F Font Mapping Table Name parameter 341
Font Name parameter 350
F Font Size parameter 350
Category Option Category List Screen, Migration, Font Subsetting parameter 343
Printing, Backup, Restore Mission Definition 152 Fonts to Ignore parameter 341
Category Option Category List Screen, Report FOOTER Option
Decollating Mission Definition 120 Edit Report Screen 256
Fail on missing resources 340 Force
Fast Exit Category in Category List Screen, Migration, Printing,
Online Facility 90, 91 Backup, Restore Mission Definition Screen 152
FCB Parameter Category in Category List Screen, Report Decollating
$SYSDATA Long Format 283 Mission Definition Screen 120
CDAM 760 FORCE Option
FDR Format 61, 63 Category List 137, 168
Features DO USER Statement 516
CONTROL-D 44 Job List 116, 137
CONTROL-V 43 Mission List 148, 168
File Set FORCE Option Category List Screen, Migration, Printing,
FileTek Storage Machine 734 Backup, Restore Mission Definition 152
File Transfer Control FORCE Option Category List Screen, Report Decollating
Commands 299 Mission Definition 120
CONTROL-D/WebAccess Server 52, 294 FORCE Parameter
Example 295 Migration Mission 723
Fields 297 RETENTION DAYS 723
INDEX Option 302 Retention Days 717
Options 298 FORCED SCHEDULING Field
Packet Screen 295 Backup/Migration Utility 412
Show Option Window 299 Printing Mission Utility 411
ZOOM Option 301 Report Decollating Utility 409
FILEID Field Restore Mission Utility 414
Index File Name 823 Foreground Color parameter 344
Files Form Field
Active Missions ... 48 User Report Lists 202, 206, 208, 211, 216
Active Transfer File 48 FORM Parameter
Conditions 48 ON CLASS Statement 560
Manual Conditions 48 OVERRIDE Parameter 706
Report List 48 Print Option Window 239
FileTek Storage Machine Summary 162
FTK 786 Form X Offset parameter 352
FILTER Field Form Y Offset parameter 352
IOA Log Show Screen Window 386 Formdef Field
Show Screen Filter 386 User Report List 208
Filtering FORMDEF Library
Log Screen 383 CDAM 762
FIND Command FORMDEF Parameter
Description 96 CDAM 589, 760
PFKey Definition 93 OUTPUT Statement 588
Report Viewing 248 FORMS

870 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Sort Key 730 PRINT/CDAM PARMS 587

FORMS Parameter Generic Decollating
$SYSDATA Long Format 283 %%JOBNAME Variable 457
FREE Option Example 448
Active Missions Screen 312 Job Name Mask 546
File Transfer Control 298 Missions 533
FREE Parameter PRINT/CDAM PARMS 587
BATCH Parameter 652 Printing Destination 833
Chunking 707 Generic Job
Summary 162 JOBNAME Parameter 546
Free Tracks Generic Output
MINIMUM Parameter 552, 689 Printing 587
PDS Parameter 584, 710 GENERIC Parameter
Freeze Columns Description 480, 524
Edit Report Columns 262, 264 Example 525
FROM PAGE Parameter Summary 125
Print Option Window 239 TASKTYPE Parameter 605
FROM Time GENERIC Status
TIME Parameter 607, 741 Active Missions Screen 308
fromcol Parameter Generic User Name
FIND Command 96 DO USER Statement 516
Fromuser Name Example 521, 802
User Report Lists 206, 208, 216 Recipient Tree 802
FROMPAGE Argument GIVE TO USER Field
SPAGE Command 251 Give To Window 237
FS Value Give To Window
External Destinations Screen 289 Active Report List 237
FSDPC Value GIVETO Option
External Destinations Screen 289 Active Report List 222, 236
FSET Parameter Global Rulers
STAGE Parameter 734 $ruler 276
Summary 164 Greater Than 268
FT Value Greater Than or Equal To 268
External Destinations Screen 289 Gregorian Date Format
FTCPC Value Definition 74
External Destinations Screen 289 Number of Characters 75
FTK Media Gregorian Date Standards
Resource Management 786 Overview 74
STAGE Parameter 734 GROUP Command
FTK Value Active Missions Screen 306
MEDIA NAME Parameter 734 Log Screen 382
FUNCTION Field GROUP Field
Prerequisite Condition Utility 416 Active Missions Screen 306
GROUP Name
Active Missions Screen 307, 311
G GROUP Parameter 526
GROUP Parameter
GE Operator 268 Description 526, 676
General Note Emergency Mission 605, 687, 739
Notepad Facility 241 Example 526, 676, 677
General Parameters MAXWAIT Period 549
Decollating Mission 125, 421 OUTGRP Parameter 676
Migration, Printing, Backup, Restore 639 Selection Criteria 311
General Profile Summary 158
Active Environment Screen Filter 383 GT Operator 268
Generic Class .GT. Operator 192
ON CLASS Statement 564

Index 871
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

H Active Missions Screen 312

File Transfer Control 298
HALF HOST Field
Scrolling Amount 95 External Destinations Screen 290
Half Tone parameter 341 HTML
Header Lines viewing a transformed report with 813
Indexing 476 HTML Parameters 344
Rulers 256, 261
HEADER Options
Edit Report Screen 256
Held Output
I
GENERIC Parameter 524 I
HELD Status Category Option Category List Screen, Migration,
Active Missions Screen 307 Printing, Backup, Restore Mission Definition 151
File Transfer Control 298 Category Option Category List Screen, Report
Mission Deletion 312 Decollating Mission Definition 119
Transfer Packets 302 I Line Edit Command 838
Zoom Screen 320 I1 ISPF Utility
Held Sysout Add Prerequisite Condition 408
ON SYSOUT Statement 563 Check Prerequisite Condition 408
HELP Command Delete Prerequisite Condition 408
PF01/PF13 98 I1 Option
PKFey Definition 93 Online Utilities Menu 415
Help Facility IBM 3270 Terminals 82
DESC Parameter 448, 674 IBM 3800/3900 Printers
HEX Command Laser Printing 587
HEX Format 249 Identifying Strings
Hexadecimal Value CONTID Parameter 621
Special Characters 82 IDMS/DC 81
Hexadecimal Values Color Support 83
Special Characters 82 Environment 50
Highlighting IMMEDIATE PRINT CLASS
Tagged Substrings 277 Packet Zoom Screen 302
HILITE Code Immediate Printing
Color Lines Screen 272 Print Option 238
Hilite Columns Selected Pages Print Option Window 252
Edit Report Columns 262, 263 Implementation Hints 791
History Report List IMS
$SYSDATA Long Format 282 Wait Message 247
$SYSDATA Short Format 280 IMS/DC 81
All Fields Display Type 214, 218 Color Support 83
CANCEL Option 241 Environment 50
Default Display Type 201, 202 IN Parameter
Description 198 Description 528, 679
Job Display Type 209 Example 529, 680
Long Display Type 212 IN PROCESS Status
Notes 241 Active Missions Screen 310
Options 240 INCLUDE Argument
Restore Window 240 SPAGE Command 251
SDSF Display Type 210 Include External Overlays parameter 341
User Display Type 205, 207 Include Internal parameter 341
Hit List Include Lines Based on Strings
Option V 246 Apply on Header Field 268
Report Retrieval 184 Color Code 269
HOLD IN PROCESS Status Description 266
Active Missions Screen 308 Line Range 269
HOLD Option Report Editing 255

872 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

INCLUDE NOTES Field Page Level 821

Give To Window 237 INDEX Field
INCLUDE Statements Index Window 234
Printing Missions 829 Quick Access Panel 229
INCLUDE USER Parameter Recipient Tree 794
Bundling Parameter 158 Subindex Window 236
CATEGORY Parameter 654 Index File
Description 682 Naming Convention 822
Example 683 PC Transfer 298
Printing Missions 654 STORE Parameter 161, 736
INCONTROL Features INDEX FILE Field
Overview 80 Packet Zoom Screen 302
INCONTROL Products Index Hierarchy
Integration 44 Design 821
Index DO INDEX Statement 472, 473
Considerations 820 Example 472
Continuous 469 Shape 472
Continuous Record Level 68 Index Level Display
DDNAMES 470 PATH Command 124
Design 68, 820 Index Mask
DO INDEX Statement 462, 469 DO INDEX Statement 465
Example 474 Index Value 66
Hierarchy Shape 472 Index Migration
Main 463 DO INDEX Statement 465
Masking 820 Index Window 234
Migration 69, 822 Planning 822
Noncontinuous 469 Summary 69
Page Level 68 INDEX Name
Page level 465 Recommendations 821
Page-level 475 INDEX Option
Paths 69, 821 Active Report List 221
REC Parameter 467 File Transfer Control 298, 302
Record Level 68 Index Pages
Record-Level 228 Account Summary Format 67
Record-level 465, 469, 475, 476 Branch Summary Format 66
Report Design 820 INDEX Parameter
Report Retrieval 65, 180, 825 DO INDEX Statement 463
Size 69, 824 Recipient Definition 177
Sort Order 824 User Reports Entry Panel 189
Specification 463 Index PATH
Testing 825 DO INDEX Statement 469
Value Mask 469 Index Path
Index / Subindex Window Method Example 69, 472
Description 183 Index Design 69, 821
Index Chain Index Level Display 124
Index Path 124 PFKeys 230
Index DDNAMES Planning 820
DDNAMES Index 470 Quick Access Panel 227
Index Definition Index Type
Index Type 465 Continuous Record Level 65
Page-Level 124 Description 65
Record-Level 121 DO INDEX Statement 465, 472
Index definition Page Level 65
LINE format 65, 462 Record Level 65
VAR format 65, 463 Index Value
Index Design Index Mask 66
Index Path 69 Mask 826

Index 873
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Page-level 820 AMNAME 760

Quick Access Panel 227 AMPREF 771
Record-level 820 AMPREFD 771, 776, 778
Report Pages 68 AMUNIT 589, 772
Subindex Window 235 Archive Server 786
Values of Index Panel 231 CTDMON# 554
INDEX VALUE SELECTION Fields ESCAPCL 587
User Reports Entry Panel 196 IXTOPC 298
Index Window JB1PREF 771, 776, 778
Bypass 185 OUTGRP 677
Description 233 Printer Name 712
Fields 221, 234 PRTMON# 693
Index Mask 189 Installation Working Date
Main Indexes 825 Shout Facility 847
Option Q 825 Interval
Options 235 Periodic Calendar 401
Report Retrieved 184 INTERVAL Parameter
Index/Subindex Window Method Cyclic Mission 127, 317
Report Retrieval 70, 184 Description 532, 684
INDPREF 822 Example 533, 685
INFO Command TASKTYPE Parameter 605
IOA Primary Option Menu 87 IOA
INITIALIZING PRINTING PLAN Status Under ISPF 99
Active Missions Screen 308 IOA Archive Server 52
INITIALIZING Status IOA Calendar Facility
File Transfer Control 297 Calendar Facility 390
INQ/UPD MEDIA DB Option IOA CDAM Server 785
IOA Menu 89 IOA Conditions
Insert File 366
Category in Category List Screen, Migration, Printing, IOA Conditions File 366
Backup, Restore Mission Definition Screen 151 IOA Conditions/Resources
Category in Category List Screen, Report Decollating Screen 366
Mission Definition Screen 119 IOA Conditions/Resources File 366
INSERT BY WEEK DAYS Option IOA Conditions/Resources Screen
Year List Screen 396 Description 366
Insert Command IOA Core
Edit Environment 838 Files 48
INSERT Option IOA Editor 101
Active Report List 222 Command line commands 102
Category List Screen 110 Edit Entry Panel 101
Category List Screen, Migration, Printing, Backup, EDMEM command 101
Restore, Mission Definition 141 PFKey functions 102
Edit Report Screen 256 Row commands 103
External Destinations Screen 289 IOA Editor screen 101
Permanent Report List 222 IOA Entry Panel 84
Recipient Tree List 175 Description 84
Year List Screen 396 IOA Gateway Monitor
INSERT Option Category List Screen, Migration, Printing, CONTROL-D Application Server 53
Backup, Restore Mission Definition 151 IOA Log File 379
INSERT Option Category List Screen, Report Decollating IOA Log Screen 379
Mission Definition 119 DISPLAY Command 382
Inserting Log Screen 316
Relevant Screen or specific item to insert 397 Messages 389
Installation Parameter IOA Log Show Screen Window
$USRNO 187 Activating 384, 385
$USRYES 187 Activating Filters 384
AMBLOCK 778 Active Environment Screen 385

874 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Exiting 389
Fields 386 J
Message Types 389 JB1PREF Installation Parameter
IOA Manual Conditions 374 ALLOCOPT=JOBSDSN1 771, 776, 778
IOA Primary Option Menu JCL ddname
Description 85 Report Name Extraction 486, 497
Option ... 312 JCL OUTPUT Statement
Option 6 407 Decollation Testing 806
Option 7 374 JCL Parameter
Option F 295 $SYSDATA Long Format 283
IOA SAMPEXIT Library JCL Syntax
User Exits 60 Description 760
IOA Scheduling Facility SUBSYS Option 760
Scheduling... 425 JCL System Dataset
IOA SET 104 ON Statement 561
IOA Variable Database Option JDE name 351
Primary Option Menu 88 Jde Name parameter 351
IOA.PARM library 823 JDE section name 351
IOAID Field JES Dataset
Conditions/Resources 368 CDAM File 470
IOALDNRS Utility 374 JES Job Number
IOASMDIA Installation Parameter $SYSDATA Short Format 281
IOASPRM Member 733 CDAM 769
IOASMDIA Macro Identification Number 544
IOASPRM Member 734 Packet Index Screen 303
Migration Mission 734 Print Plan Screen 324
IOASPRM Member Shout Facility 849
Archive Server Parameter 785 User Report Lists 204, 209, 211, 216
IOASPRM member 823 Zoom Screen 316
IOAUTIL CLIST JES Outgroup
Online Utilities 407 Chunking 707
Is Waiting For: Screen JES Print Destination
Example 312 PRINTER Parameter 712
ISPF 94 PRINTING ON dest 308
PACK Option 391 JES Spool
Primary Option Menu 85 CDAM 757
Wait Message 247 JES2
ISPF Commands DO SHOUT Statement 510
Priority 100 PRINT/CDAM PARMS 587
ISPF/PDF Facilities SHOUT Parameter 601, 726
Online Facility 106 JES3
ISPF/PDF Primary Option Menu *T Command 510
ISPF KEYS Command 100 DO SHOUT Statement 510
ISPSTART Command PRINT/CDAM PARMS 587
ISPF Keys 100 Printing Characteristics 806
IXHPREF Field SHOUT Parameter 601, 726
Index File Name 822 JNAME Value
IXHPREF Parameter JES3 Print Destination 308
CTVPARM Member 822 Job Archiving Facility
IXHPREF parameter 822 Summary 186
IXPREF 822 JOB DEFAULTS Parameter
IXTOPC Parameter *SPOOL Destination 537
CTVPARM Member 298 COPIES 534, 762
Decollating Parameters 128, 428
DEST Parameter 536
LVL Parameter 538
MAX COPIES 540, 575, 762

Index 875
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Printing Destination 833 Example 545

USER Parameter 542 User Reports Entry Panel 197
Value 99 762 JOBNAME Field
Job Display Type Log Screen Filter 388
Additional Info Option 210 Packet Index Screen 303
Fields 209 Print Plan Screen 324
User Report Lists 209 User Report Lists 209, 211
Job Entry Time Stamp JOBNAME Parameter
$SYSDATA Long Format 283 CDAM 769
Job Field Description 546
Report List Header 200 Example 546
Job ID Field Summary 125
Zoom Screen 316 User Reports Entry Panel 197
Job Identification JOBSDSN1 Decollation
JOBID Parameter 544 Job Archiving 186
Job List Screen JOBSDSN1 Option
BROWSE Option 110 ALLOCOPT Parameter 281, 764
Confirmation Window 137 JOBSDSN2 Option
Delete Option 117 ALLOCOPT Parameter 764
Example 116, 137 JSL file name 351
Insert Option 116 Jsl name 351
Options 110, 116, 137 Jsl Name parameter 351
Job Log Console Messages JTYPE Parameter
ON Statement 561 $SYSDATA Long Format 283
JOB MSGCLASS Output Julian Date
MSGCLASS Output 192 CDAM 768
Job Name Shout Facility 849
$SYSDATA Short Format 281 Julian Date Format
Generic 525 Definition 75
Report Editing 254 Julian Date Standards
Report Viewing 248 Overview 75
Shout Facility 849
Sort Key 729
User Report Lists 202, 204, 208, 209, 211, 213, 216
JOB NAME Field
K
Printing, Backup, Restore Mission Entry Panel 142 KEEP Ruler Active Option
Quick Access Panel 229 Exit Option Window 274
Report Decollating Mission Facility Entry Panel 111 Keyboard Character
Job Name Mask Hexadecimal Value 82
Generic Output 546 KEYS Command
JOB ORDER ISSUE Option ISPF/PDF Primary Option Menu 100
Online Utilities Menu 407 KOA Recorder Option
Job Parameters Primary Option Menu 89
$SYSDATA Long Format 283
JOB SCHEDULE DEF Option
IOA Menu 88
Job Start Date Field
L
User Reports Entry Panel 189 Laser Printer
JOB STATUS Option Considerations 587
Primary Option Menu 88 PRINT/CDAM PARMS 587, 806
Job Type Field Printing Control 826
User Report Lists 211 Printing Organization 826
Job Type Parameter User Exits 60
$SYSDATA Long Format 283 Last Refresh Date
JOBID Parameter Primary Migrated CDAM 284
CDAM 769 LATE TIME Value
Description 544 SHOUT Parameter 599, 724

876 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

LE Operator 268 User Report Lists 201, 206, 210, 217

LEFT Command Lines Printed
Report Viewing 248 Print Plan Screen 324
Length of input records parameter 347 Linklist Library
Less Than 268 Recipient Tree 792
Less Than or Equal To 268 LOCATE Command
Level Code Description 95
Recipient Tree 174, 791 Values of Index Panel 233
LEVEL of Recipient Location Commands
Recipient Tree List 174 Edit Environment 837, 838
LEVEL Parameter LOCNOTE Command
LVL Parameter 538 Report Viewing 278
LEVEL Sort Key 730 LOCVAL Command
LEVELS Display/Hide Report Viewing 250
Recipient Tree List 174 LOG 7Option
Library Active Missions Screen 312
Maintenance 553, 585, 690, 711 Log Entry Type Field
LIBRARY FIELD Migration Log 285
Migration, Printing, Backup, Restore Mission Log File
Definition Entry Panel 144 Description 49
Report Decollating Mission Definition Entry Panel 111 Job Deletion 117
LIBRARY Field MAXWAIT Parameter 549
Calendar Facility Entry Panel 392 Mission Deletion 149
Line Advance method parameter 352 Print Plan Screen 325
Line Commands Recipient Tree Errors 178
Options 221 Reporting Facility 54
Line Content LOG Option
Selection Criteria 267 Active Missions Screen 312, 315
Line Delimiter Dec parameter 349 Primary Option Menu 86
Line Delimiter Delete parameter 349 Log Screen
Line Delimiter Hex parameter 349 CATEGORY Command 382
Line Delimiter Length parameter 349 Commands 381
Line Delimiter String parameter 349 Description 379
Line Delimiter Type parameter 350 Example 92, 315
Line Editing Fields 380
Recommendations 838 Filtering 383
Line Editing Commands 838 GROUP Command 382
LINE format Log Screen Filter
Index definition 65, 462 Window 381
LINE Parameter Logic
DO INDEX Statement 465 AND/OR 131, 665, 747
DO NAME Statement 483 Long Display Type
DO REMARK Statement 495 Fields 213
DO SET Statement 502 User Report List 212
DO USER Statement 513 LPR Value
Index Mask 467 External Destinations Screen 289
WHEN Statement 619, 623 LRECL Parameter
Line Range $SYSDATA Long Format 283
Edit Report Columns 264 LT Operator 268
Include Lines Screen 267, 269 .LT. Operator 268
LINECT Parameter LVL Parameter
CDAM 770 Description 538
PRINT/CDAM PARMS 590 DO INDEX Statement 468
LINES Field DO USER Statement 513
$SYSDATA Short Format 281 Example 538
Packet Index Screen 304 ON STATEMENT DEFAULTS 572
Print Plan Screen 324

Index 877
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

M MAX SIZE Parameter

Recipient Definition 178
Machine Control Codes MAXCONN Parameter
ASA Code Translation 655 FTK Media 786
Main Index MAXCOPIES Parameter
DO INDEX Statement 462 PRT COPIES Parameter 575
Index Window 233 MAXWAIT Parameter
Values of Index Panel 231 Description 548, 686
Maintenance Example 549, 687
Libraries 553, 585, 690, 711 Mission Scheduling 126, 159
Manual Conditions 374 MB Line Editing Command 837
Add Condition 376 Media Control
Summary 48 Archive Server 785
Manual Conditions Screen MEDIA Field
Fields 375 Index Window 234
Options 377 Migrated CDAM 284
Manual Intervention Migration Log 285
OUT Parameter 579, 703 Media Management
MASK Archive Server 785
CAPS Command 122 MEDIA NAME Parameter
Mask Characters 189 STAGE Parameter 734
Mask Definition Media Type
Mask Value 66 $SYSDATA Long Format 283
Mask Fields Index Window 234
INDEX Parameter 189 MEM/MIS Field
REMARK / CCs Parameter 192 Log Screen Filter 388
REPORT NAME Parameter 188 Member
USER Parameter 188 Browse Mode 111
MASK Parameter Creation in Report Decollation Mission Facility 109
DO INDEX Statement 467 Deletion 111
Recordlevel Index 821 MESSAGE Field
Mask Value Log Screen 381
Indexes 826 Message Generation
Page-level Index 820 DO SHOUT Statement 509
Record-level Index 820 SHOUT Parameter 599, 724
Masking Message Line
Description 83 Online Facility 92
INDEX Parameter 189 Message List Screen
Index Value 469 Recipient Tree Errors 175
Master Console Message Type
SHOUT Parameter 600, 725 IOA Log Show Screen Window 389
Master Password parameter 343 MESSAGE TYPE Field
Matching String 83 Log Screen Filter 387
Max Chars in Line parameter 349 Message Type Field
MAX COPIES Parameter Show Screen Filter 387
COPIES Parameter 534 Messages
Description 540 Log File 389
Example 541 MF RETAIN Parameter
JOB DEFAULTS 128 Recipient Definition 178
ON STATEMENT DEFAULTS 573, 575 Mig Date Field
PRT COPIES Parameter 575 Migration Log 285
MAX Field MIG Type Migration
Conditions/Resources 367 Migration Mission 642
Max Lines in Page parameter 349 Stage 01 Scheduling 642
Max Render Pages parameter 341 MIG Value
MAX Scroll TASKTYPE Parameter 738
Scrolling Amount 95 MIGRATE IN PROCESS Status

878 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Active Missions Screen 309 Scheduling Parameters 643

MIGRATE Parameter STAGE Parameter 734
STORE Parameter 161, 736 Stage specification 733
Migrate Volume Field Stages 643
Migrated CDAM 284 Migration Stages
Migrated CDAM Files Scheduling 159
$SYSDATA Records 285 Migration Utility
Migrated Files ISPF (Online) 411
Second Copy 722 Migration, Printing, Backup, Restore Mission Definition
Migrated Report List Creation 141
$SYSDATA Records 284 Entry Panel 144
Additional Info Option 284 General 140
Entry Panel 198 Screen 140
Fields in Long Format 284 Migration, Printing, Backup, Restore Mission Definition
Status Field 219 Entry Panel
Migrated Reports Search Window 145
$SYSDATA Record 284 Table Creation 141
Indexes 69, 234, 465, 822 MINIMUM Parameter
Notes 241 CONFCAL Parameter 434, 660
Viewing 247 DATES Parameter 436
MIGRATED Status DAYS Parameter 442, 667
User Report Lists 219 Description 552, 689
Migration Example 553, 690
DASD Target 785 MONTHS Parameter 556, 695
Initial Scheduling 642 PDS Parameter 584
Mission Names 482 WDAYS Parameter 614, 750
Subsequent Scheduling 643 MINIMUM PDS Tracks
Migration Date Mission Trigger 126, 159
Migrated CDAM 284 MISNAME Parameter
Migration Log Active Missions Screen 310
Information 285 Mission
Migration Mission Browse Mode 142
# OF DAYS TO KEEP 164 Deletion 142
DO MIGRATE Statement 131, 481 Mission Definition
Duplicate Name 481 CANCEL Command 167
Example 154, 636, 723 Category List Screen 149
FORCE Parameter 717 Copying to another member (mission) 169
Indexes 69, 234, 465, 822 Deletion 142
Mission Name 481, 691 Dependency 71
Parameters 153, 163, 643 Description 152, 635
Priority 715 Editing 133, 165, 836, 839
RETENTION DAYS Parameter 717 Exiting 166
Scheduling 642 Libraries 49
Scheduling Utility 411 Migration Missions 636
SECONDARY MEDIA NAME Parameter 722 Mission List 147
SECONDARY SKELETON 722 Missionspecific Parameters 163
Skeleton Job 723 Parameters 648, 650, 712
STAGE Parameter 733 Postprocessing 160
Stages 642 Prerequisite Condition 71
TASKTYPE Parameter 738 Priority 592, 715
Types 642 Report Decollating 419, 420
Workflow 58 Saving Definitions 166
Zoom Screen 316, 317, 318 Mission Description
Migration Mission field DESC Parameter 674
$SYSDATA Long Format 283 Mission Information
Migration Path Active Missions Screen 306
DO MIGRATE Statement 481 MISSION LIBRARY Field

Index 879
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Backup/Migration Utility 412 Printing Missions 641

Printing Mission Utility 410 ML Line Edit Command 837
Report Decollating Utility 409 MM Line Edit Command 837
Restore Mission Utility 413 MODIFY
Mission List Sort Key 730
Active Missions Screen 305 MODIFY Parameter
Mission List Screen $SYSDATA Long Format 283
Confirmation Window 168 CDAM 760
Delete Option 149 Zoom Screen 320
Options 148, 168 Monitor 60
Mission Name MONITOR Parameter
Active Missions Screen 306 BATCH Parameter 653
Mission Order Description 554, 693
Manually 168 Example 555, 693
Messages Screen 169 Summary 125, 157, 646
MISSION Parameter Monitor Status Field
Description 691 Active Missions Screen 306
DO PRINT Parameter 691 MONTHS Parameter
Example 691 DATES Parameter 436, 556, 695
Restore Mission 691 Description 556, 695
SECODNARY SKELETON 722 Example 556, 695
Secondary Skeleton Name 722 MINIMUM Parameter 552, 689
Summary 157 PDS Parameter 584, 710
Mission Parameters Periodic Value 442, 614, 667, 750
Decollating 54, 420 Summary 159
Definition Screen 152 Move Commands
Migration, Printing, Backup, Restore 57 Edit Environment 837
Summary 422, 641 MOVE Option
Zoom Screen 320 CTDAMUTI Utility 782
Mission Priority MQ Parameter
PRIORITY Parameter 592 ON Statement 129
Mission Retrieval Criteria MQ QUEUE Parameter
SHOW Command 309 Description 558
Mission Scheduling MS Line Edit Command 837
Scheduling 123 MS Parameter
Mission Status SHOUT Parameter 601, 726
Active Missions 304, 306, 310 MSG Library
Printing 322 Online Help 99
Requested Return 321 MSG STATISTICS Option
Wait Schedule 312 IOA Menu 89
Mission Trigger MSGCLASS Output
NOT LATER THAN 697 $JOBCHK Ruler 276
Mission Type Abend Codes 192
Active Missions Screen 306 ALLOCOPT Options 779
MISSION/JOB NAME Field CDAM 764
Backup/Migration Utility 412 Condition Codes 206, 210, 212, 216
Printing Mission Utility 410 REMARK / CCs Parameter 192
Report Decollating Utility 409 SEARCH Parameter 519
Restore Mission Utility 413 Termination Codes 206, 210, 212, 216
Missions User Report Lists 209
Creation 141 MSM Type
Missionspecific Parameters Migration Mission 642
# OF DAYS TO KEEP 648 Stages 02 10 Scheduling 643
# OF GENERATIONS TO KEEP 650 Multi-screen Control
Backup Missions 164, 641 Description 90
Migration Missions 164, 641 Multiple DO Statements
PRINTER Parameter 712 Decollating Parameters 428

880 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Multiple Occurrence Fields Schedule Date 455, 703

$SYSDATA Parameter 177, 794 NEXT TIME Field
ADDRESS Parameter 177, 794 Zoom Screen 317
AUTHORIZE Parameter 177, 794 NEXTCTG Command
DESC Parameter 125, 177, 793 Decollating Mission 135
DO Statements 131 Mission Definition 166
EXCLUDE USER 158 NEXTPAGE Command
IN Parameter 127, 160 Report Viewing 248
INCLUDE USER 158 NEXTYEAR (PF11/PF23) Command
MISNAME Parameter 310 Calendar Definition Screen 405
Mission Definition 152 NOBANNER Value
ON FORM Parameter 161 CATEGORY Parameter 655
ON Statements 129 Node
OUT Parameter 128, 161 Report Destination 832
Report Decollating Mission 120 Non-existing Conditions 48
SHOUT Parameter 161 NONAME Value
SYNONYM Parameter 177, 793 DO NAME Statement 484
Multijob CDAM Dataset Noncontinuous Index
Allocation Algorithm 775, 777 Description 467
ALLOCOPT Parameter 765 NonHeld Output
CDAM Prefixes 778 GENERIC Parameter 524
CTDAMUTI Utility 784 NonHeld Sysout
MUST Parameter ON SYSOUT Statement 563
DO PRINT Statement 492 normalized page
MVS Environment transformation of binary reports 809
CDAM 773 NORULER Value
ISPF CLIST 42 CATEGORY Parameter 655
Not Equal To 268
NOT LATER THAN Parameter
N Description 697
Example 697
NAME Field Summary 160
Active Missions Screen 306 Not Printed Status
Manual Conditions Window 377 Show Options Window 193
Naming Convention User Report Lists 219
CDAM Datasets 776 Note Field
Index File 822 User Report Lists 202, 217, 232
NE Operator 268 NOTE Option
NEW Command Active Report List 221
Notepad Facility 244 Notepad Facility
NEW COND Command Commands 243, 244
Manual Conditions 376 Confirmation Window 245
New Day Procedure Exit 245
DCAL Calendar 664 General Notes 241
Description 51 Migrated Reports 241
NEW PASSWORD Field Multiple Versions 242
IOA Entry Panel 85 Tag Notes 241, 276
New Report Clique Definition NOTES
creating 331 Give To Window 237
NEXT NOTES Total
Schedule Date 579 Report Viewing 248
NEXT Command NOTOK Status
Notepad Facility 244 Active Missions Screen 305
PF11/PF23 Key 93 Causes 646
Quick Access Panel 227, 228, 230 Decollating Missions 427
Recipient Tree List 175 DO NOTOK Statement 133, 490
NEXT Date Reference Mission Status 305

Index 881
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Show Windows Option 192 PRINT/CDAM PARMS 764

NOTOK Value ON DSN Statement
SHOUT Parameter 599, 724 CDAM 770, 774
NORESTORE Option Description 564
History Report List 222 Example 566
NULL User Merged with DSN Parameter 522
Recipient Tree 802 ON FORM Parameter
Number of Columns parameter 340 For Future Use 641, 647
Number Of Days To Keep ON LINE# Parameter
# OF DAYS TO KEEP 648 For Future Use 699
Number Of Generations To Keep ON MQ Statement
# OF GENERATIONS TO KEEP 650 Description 561
Number of Rows parameter 340 ON PAGE# Parameter
Description 700
Example 701
O INTERVAL Parameter 684
Page Threshold 160, 700
O Printing Mission Trigger 739
Category Option Category List Screen, Migration, TASKTYPE Parameter 739
Printing, Backup, Restore Mission Definition 151 ON Statement
Category Option Category List Screen, Report Decollating Parameters 129
Decollating Mission Definition 119 Description 560
ODAT Example 565
Schedule Date 579 Multiple 564
ODAT Date Reference ON STATEMENT DEFAULTS
Schedule Date 455, 528, 679, 703 *SPOOL 537
ODATE Decollating Parameters 428
Active Missions Screen 306 Description 572
Date Force Option 774 Example 575
Description 74 JOB DEFAULTS 540
MAXWAIT Parameter 548 MAX COPIES Parameter 575
Quick Access Panel 229 Overriding Parameters 573
Quick Access Report List 227 Printing Destination 833
Report Viewing 248 Unidentified Pages 833
RETRO Parameter 594, 719 ON STRING Statement
Shout Facility 847 Color Lines Screen 271
User Report Lists 201, 206, 210, 212, 216 ON SYSDATA Statement
User Reports Entry Panel 189 Example 567
Zoom Screen 317 ON SYSJCL Statement
ODATE Field Description 561
Log Screen 380 ON SYSLOG Statement
OK Status Description 561
Decollating Missions 427 ON SYSMSG Statement
Mission Status 305 Description 561
SHOUT Parameter 646 ON SYSOUT Statement
Show Windows Option 192 Description 564
OK Value ON TRNCLASS statement
SHOUT Parameter 599, 724 Description 562
ON Block Report Cliques 562
Decollating Parameters 121, 428 ON TRNDSN statement
Printing Missions 492 Description 563
ON CLASS Statement Report Cliques 563
DDNAMES Index 470 ONEDSN Option
Description 560 ALLOCOPT Parameter 281, 764
Example 565, 575 Online Facility
Generic Class 564 Active Missions Screen 304
NonHeld Sysout 565 Color Support 82

882 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Customization 80 Online Utilities 100

Description 49 Primary Option Menu 86, 407
Exiting 91 Option 7
Recipient Tree 171 Primary Option Menu 86, 374
Report Editing 253 Option 8
Report Viewing 180, 246 Primary Option Menu 86
Restricting Displays 583 Option A
TSO Application 107 $SYSDATA Records 286
TSO Command Screen 106 IOA Menu 87
Under ISPF 99 Migrated Report List 284
User Reports 179 Primary Option Menu 305
Online Tracking and Control User Report Lists 222
Online Facility 304 Why Screen 313
Online Utilities Menu Option B
Utility Screen 407 Job List 116
Online Viewing Mission List 148
Report Viewing 64 Option BA
OPER Value Primary Option Menu 89
DO SHOUT Destination 509 Option BB
SHOUT Parameter 600, 725 Primary Option Menu 89
OPER2 Value Option BM
DO SHOUT Destination 509 Primary Option Menu 89
Operator Action Required Option BR
Mission Status 305 Primary Option Menu 89
Operators Option BV
String Comparison 267 Primary Option Menu 89
OPT Field Option C
Conditions/Resources 367 Edit Report Columns 262
Manual Conditions 375 History Report List 222
opt Parameter Primary Option Menu 89
DO COND Statement 455 Option D
OUT Parameter 579, 703 $SYSDATA Records 286
OPTCD Parameter Active Missions List 312
$SYSDATA Long Format 283 Conditions/Resources 371, 372
CDAM 760 File Transfer Control 298
TRC Parameter 763 Job List 116
Optical Disk Job List Screen 111
Archive Server 785 Mission List Screen 142
Queuing Mechanism 785 Recipient Tree List 174
Wait Message 247 User Report Lists 222
Option 324 Option D1
Option > Online Utilities Menu 409
Print Plan Screen 324 Option D2
Option ? Online Utilities Menu 410
Active Missions Screen 312 Option D3
Option 1 Online Utilities Menu 411
Selected Pages Print Option Window 252 Option D4
Option 2 Online Utilities Menu 413
IOA Menu 88 Option DO
Option 3 Primary Option Menu 328
Primary Option Menu 88 Option E
Option 4 Active Report List 222
Primary Option Menu 86 Option F
Option 5 Active Missions Screen 312
IOA Menu 379 Category List 137, 168
Primary Option Menu 86 File Transfer Control 298
Option 6 IOA Menu 87, 295

Index 883
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Job List 116, 137 Option OM

Mission List 148, 168 IOA Menu 89
OPTION Field Option OR
User Reports Entry Panel 186, 198 IOA Menu 89
Option Field Option OS
Active Missions Screen 306 IOA Menu 89
External Destinations Screen 288 Option P
Index Window 234 Active Report List 221
Values of Index Panel 232 File Transfer Control 298
Option G Recipient Tree List 175
Active Report List 222 Values of Index Panel 232
Option H Option Q
Active Missions Screen 312 Active Report List 222, 825
File Transfer Control 298 Index Window 235
Option I Quick Access Report List 226
Active Report List 222 User Reports Entry Panel 825
File Transfer Control 298 Option R
Permanent Report List 222 Active Missions Screen 312
Recipient Tree List 175 File Transfer Control 298
Option I1 History Report List 222, 240
Online Utilities Menu 407, 415 IOA Menu 87
Option IV Primary Option Menu 109
Primary Option Menu 88 Option R1
Option L Online Utilities Menu 407
Active Missions Screen 312 Option R2
Option M Online Utilities Menu 407
IOA Menu 87, 828 Option S
Primary Option Menu 140 Index Window 235, 825
Option M1 Job List Screen 116
Online Utilities Menu 407 Mission List 148
Option M2 Recipient Tree List 174, 176
Online Utilities Menu 407 Subindex Window 235
Option M3 Values of Index Panel 229, 232
Online Utilities Menu 407 Option T
Option M4 IOA Menu 87, 793
Online Utilities Menu 407 Primary Option Menu 171
Option M5 Option TC
Online Utilities Menu 407 Primary Option Menu 89
Option M6 Option TI
Online Utilities Menu 407 IOA Menu 89
Option N Option TP
Active Report List 221, 241 IOA Menu 89
Option Number Option TR
User Reports Entry Panel 186, 198 IOA Menu 89
Option O Option TSO
Category List 137, 168 Primary Option Menu 87
History Report List 240 Option TV
Job List 116, 137 IOA Menu 89
Mission List 148, 168 Option Type
Option OA Report List Header 200
IOA Menu 89 Option U
Option OC $SYSDATA Records 286
Primary Option Menu 89 IOA Menu 87
Option OK Primary Option Menu 186
Primary Option Menu 89 User Report List 222
Option OL Option U1
IOA Menu 89 Online Utilities Menu 407

884 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Option V Exit 273

$SYSDATA Records 286 File Transfer 298
Active Report List 221 FOOTER 256
Primary Option Menu 246 FORCE 116, 120, 137, 148, 152, 168, 516, 799
Values of Index Panel 232, 250, 825 FREE 298, 312
Option X GIVETO 237
Active Report List 221, 233, 825 HEADER 256
Active User Report List 233 History Report List 240
Online Utilities Menu 407 INDEX 302
Selected Pages Print Option Window 252 Index Window 234, 235
Values of Index Panel 232, 235, 825 INSERT 119, 141, 151, 175, 222, 256
Option Z IOA INFO 87
Active Missions Screen 312 ISPF Primary Option Menu 100
File Transfer Control 298 Job List 111, 116, 136
Options JOB ORDER ISSUE 407
$SYSDATA Records 285 JOB STATUS 88
*FORCE 516, 799 JOBSDSN1 281, 764
Active Missions Screen 311 JOBSDSN2 764, 766
Add Condition 313 KEEP Ruler 274
ADD INFO 222 KOA Recorder 89
Additional Info 202, 210, 212, 218, 282, 284, 286 LOG 86, 312, 315
ALLOCOPT 778 MANUAL COND 86
AMS 87 Manual Conditions Screen 377
AUTOMATION LOG 89 Mission List 142, 168
AUTOMATION OPTION 89 Mission List Screen 148
BALANCING DEF 89 MISSIONS 87
BALANCING STATUS 89 MOVE 782
BEFORE 256 MSG STATISTICS 89
BROWSE 116, 148 NOTE 221
CALENDAR 86 NORESTORE 222
CANCEL 241 ODATE 773
Category List 137, 167, 168 ONEDSN 281, 764
Category List Screen, Migration, Printing, Backup, ORDER 116, 119, 137, 148, 151, 168
Restore Mission Definition 151 Parameter Prompting 407
Category List, Report Decollating Mission Definition PCFILES 87
119 Prerequisite Condition 407
CHANGE 373 Primary Option Menu 85
CheckIn Ext. Vol. 89 PRINT 221, 232, 238, 298, 300
CLASS 129, 560 PRINT CONTROL 324
CLEANUP 407 Print Plan Screen 325
CLEAR Ruler 274 QUICK ACCESS 222, 235
CMEM Definitions 89 QUICK SCHEDULE 407
CONTROL-D Reports Cliques List 331 Recipient Tree List 174
CONTROL-D Resource Sets List 356 Report List 218
CONTROL-D Resources List 357, 359, 362 Report Retrieval 182
COPY 120, 152, 782 REPORTS 87
COSMOS Status 89 RERUN 312, 322
CREATE Recipient 178 RES 86
Date Force 774 RESTORE 240
DB VARIABLE DEF 89 RETRANSMIT 298
DELETE 111, 116, 119, 142, 151, 174, 256, 286, 298, 312, RETURN 321
327, 369, 371, 782 RULE ACTIVITY 89
Delete Condition/Resource 372 RULE DEFINITION 89
DISPLAY 193 RULE STATUS 89
DOCU/TEXT 407 Ruler Edit 254
EDIT 222, 254 SCHED DEFINITION 88
EXIT 407 SELECT 116, 119, 148, 151, 174, 229, 235

Index 885
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

SHOW 304 Description 702

Show Windows 193 DO COND Statement 457, 581
Skip to Report 325 Example 581, 705
Subindex Window 235 Logic 580, 705
SUBSYS 760 Prerequisite Conditions 128, 160, 646
TREE 87 OUTGRP Installation Parameter
TSO 86 GROUP Parameter 676
USER 87 OUTLIM Parameter
USER INTERFACE 407 CDAM 760
User Report Lists 221 OUTPARM Library
User Reports Entry Panel 198 Printing Characteristics 830
Values of Index Panel 232 Output Field
VIEW 221, 246 User Report List 208
WHY 313 OUTPUT Parameter
Year List Screen 396 $SYSDATA Long Format 217, 283
ZOOM 301, 316 CDAM 760
Order Printers Control Monitor 762
Category in Category List Screen, Migration, Printing, SUBSYS=CDAM 762
Backup, Restore Mission Definition Screen 151 Output Queue
Category in Category List Screen, Report Decollating WHEN IN QUEUE 628
Mission Definition Screen 119 OUTPUT Statement
ORDER Option CONTROL-D 589
Category List 137, 168 FORMDEF 588
Job List 116, 137 PAGEDEF 588
Mission List 148, 168 Printers Control Monitor 588
ORDER Option Category List Screen, Migration, Printing, Overlay Lines
Backup, Restore Mission Definition 151 Dynamic Extraction 258
ORDER Option Category List Screen, Report Decollating Rulers 256, 257, 260
Mission Definition 119 OVERRIDE Parameter
ORDERID Field Description 706
IOA Log Show Screen 388 Example 707
Ordering Summary 646
Decollating Missions 136 Overriding Parameters
Job List Screen 116 ON STATEMENT DEFAULTS 573
Manually 136, 168 Printing Characteristics 830
Migration Missions 168 OWNER Field
Printing Missions 168 Active Missions Screen 306
Restore Missions 168 Owner of Report Clique parameter 339
Ordering Multiple Missions OWNER Parameter
Category List Screen, Printing, Backup, Restore Description 708
Mission 143 Example 583, 708
Organization Levels Summary 158
Defining 791 Ownership Type
Original Line Resources 367
Edit Report Columns 262
Original Scheduling Date
ODATE 74, 719
OS390 Resource Library List Name parameter 340
P
OSS Media PA2 Key
Archive Server 786 PRINT 94
Wait Message 247 REFRESH 94
OSS Value Packet
MEDIA NAME Parameter 734 Printing 300
OTHER Status Packet Index Screen
Active Missions Screen 310 Example 302
OUT Parameter Fields 303
Decollating Missions 426 PACKET SIZE

886 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

File Transfer Control 297 Packet Index Screen 304

Packet Zoom Screen 301 Print Plan Screen 324
PACKET TOO LARGE Status Quick Access Report List 227
File Transfer Control 297 User Report Lists 201, 206, 210, 212, 217
Packet Transfer Status Pagelevel Index
File Transfer Control 297 Index 467
Show Option Window 299 Paper Types 827
Packet Zoom Screen Parallel Decollating
Example 301 MONITOR Parameter 554
Exiting 302 PARAM PROMPTING Option
Fields 301 Online Utilities Menu 407
Parameters 302 Parameters
PAGE Backup 57, 641
Scrolling Amount 95 Backup Mission 164
Page Control Characters Basic Scheduling 158, 642
CDAM 770 Batch Printing 161
PRINT/CDAM PARMS 590 Bundling 158
Show Page Mode 249 CDAM 760
Page Data X Offset parameter 346, 352 Description 429, 647
Page Data Y Offset parameter 352 Dynamic Extraction 259
Page Delimiter At End parameter 349 General 157, 641
Page Delimiter Dec parameter 349 Index Value Selection 197
Page Delimiter Delete parameter 349 Migration 57, 641
Page Delimiter Hex parameter 349 Mission Specific 161
Page Delimiter Pos parameter 349 Modification 320
Page Delimiter String parameter 349 Printing 57, 641
Page Height in Inches parameter 339 Printing Mission 161
Page Level Printing, Batch 162
Index Type 65 Recipient Definition 176, 793
Page Level Index Recipient Tree 173
Index, Page Level 68 Restore 57, 641
Page Mode Runtime Scheduling 159
DO REMARK Statement 495 Scheduling 448
LINE Parameter 623 Specific 646
Ruler 249 User Reports Entry Panel 189
Rulers 276 Zoom Screen 320
Page Mode Ruler PARENT LEVEL Parameter
WRAP Command 250 Recipient Definition 176
Page On Demand Recipient Tree 793
CONTROL-D Application Server 53 PARENT of Recipient
Page Range Recipient Tree 174
Print Option Window 239 PARENT Parameter
Report Sections 239 Recipient Definition 176
Page Threshold Recipient Tree 793
ON PAGE# Parameter 700 Parenthesis 528, 679
Page Width in Inches parameter 339 PARMMCD Library
Page-level Index $$FRM Member 187
Mask 820 Password
Pagedef Field Online Facility 85
User Report List 208 Paste Columns
PAGEDEF Library Edit Report Columns 262
CDAM 762 PATH Command
PAGEDEF Parameter Index Level Display 124
CDAM 589, 760 PC Parameters
Output Statement 588 Recipient Definition 177
PAGES Field PC Parameters Field
$SYSDATA Short Format 281 Recipient Tree 794

Index 887
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

PC PATH Field DEST Field 832

Packet Zoom Screen 302 Long Display Type 212
PC PATH Parameter Printing Mission Name 831
Recipient Definition 177 SEARCH Parameter 519
PC RETAIN Parameter User Display Type 205, 207
Recipient Definition 177 PF01/PF13
PC Transfer HELP Command 98
HELD State 302 PF02/PF14
Index Files 298 SPLIT Command 100
Packet Zoom Screen 302 PF02/PF14 Key
Report Backup 770 SHOW Command 309
Show Option Window 299 PF03 Key
Transmission Status 297 Notepad Facility 244
PCARCH Parameter PF03/PF15
CDAM 770 IOA Log Show Screen Window 390
PCL Margins parameter 345 PF03/PF15 Key
PCL Paper Source parameter 345 END Command 99
PCL Resolution parameter 345 PF04 Key
PCL Scale parameter 346 Notepad Facility 244
PCL X Offset parameter 346 PF04/PF16 Key
PCL Y Offset parameter 346 RESET Command 98
PDF 330 Return to Entry Panel 230
viewing a transformed report with 812 PF05 Key
Pdf Raster parameter 343 Notepad Facility 244
PDF Reports PF05/PF17
CONTROL-D Report Clique Screen 337 FIND Command 96
Pdf Resolution parameter 343 PF06 Key
PDS Parameter Notepad Facility 244
CONFCAL Parameter 434, 660 Tag Note Window 276
DATES Parameter 436 PF06/PF18
DAYS Parameter 442, 667 =6 Command 108
Description 584 PF07 Key
Example 585, 711 Notepad Facility 244
MINIMUM Parameter 552 PF07/PF19
Mission Trigger 126, 159 Filtering 390
MONTHS Parameter 556, 695 PF07/PF19 Key
WDAYS Parameter 614, 750 Search Top Down 310
PDSE Library 585, 711 PF08 Key
PDSMAN 117, 149 Notepad Facility 244
$$$SPACE Member 404 PF08/PF20
PENDING Field Filtering 390
Manual Conditions 376 PF08/PF20 Key
Periodic Calendar 400, 402 Next Index Path 230
Calendar, Facility 667 Search Bottom Up 310
Overlapping 402 PF09/PF21
WCAL Subparameter 613 SWAP Command 100
WDAYS Parameter 441, 614, 667, 749 PF10 Key
Periodic Mission Notepad Facility 244
Cyclic Mission 604 PF10/PF22
Periodic Scheduling Show Screen Filter 390
DAYS Parameter 440, 666 PF10/PF22 Key
Periodic Value LEFT or PREV 93, 230
MONTHS Parameter 556, 695 PF11 Key
Permanent Report List Notepad Facility 244
All Fields Display Type 214 PF11/PF23
Default Display Type 201 Log Screen 381
Description 198 PF11/PF23 Key

888 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

RIGHT or NEXT 93, 230 SHOUT Parameter 646

PFKey Definition Summary 640
PRINT Command 100 Postspool Jobs
TSO CTMTTRA 108 INTERVAL Parameter 533
PFKey Display PREF Command
SHPF Command 93 Notepad Facility 244
PFKey functions PREFIX Field
IOA Editor 102 Manual Conditions 369, 376
PFKeys Prefix Field
Active Missions Retrieval 310 CATEGORY 310
Assignment 93 COND NAME 311
Command Parameters 94 GROUP 311
DOWN 95 MISNAME 310
DOWN Command 93 REPORT NAME 188
END Command 99, 248 USER 188
HELP 98 USERID 311
LEFT Command 93, 248 PREFIX Parameter
NEXT Command 93 CDAM 771, 778
Next Index Path 230 STAGE Parameter 734
Notepad Facility 244 Summary 164
PREV Command 93 Prefixing
Quick Access Panel 228, 230 Description 83
RESET Command 98 Quick Access Panel 228, 232
Return to Entry Panel 194 PREREQ CONDITION Option
RIGHT Command 93, 248 Online Utilities Menu 407
SHOW Command 309 Prerequisite Condition
SHPF Command 93 Add/Check/Delete Utility 415
Tag Note Window 276 Adding 313, 370, 376, 579, 703
UP 95 Date Reference 456
UP Command 93 Date reference 580, 704
PGDEF Parameter Decollating Trigger 524
$SYSDATA Long Format 217, 283 Deleting 372, 378, 580, 704
Pgmstep Field Dependency 71
$SYSDATA Short Format 281 Description 70
PGMSTEP Parameter DO COND Statement 132, 454, 704
CDAM 770 Erasing 372, 378, 580
ON SYSOUT Statement 562 IN Parameter 680
Platter Field Manual Intervention 579, 703
Migrated CDAM 284 NOT LATER THAN 697
Migration Log 285 OUT Parameter 578
Platter Prefix Overview 70
STAGE Parameter 734 Printing Missions 830
Platter Switching Prerequisite Conditions
OSS Media 786 IOA Conditions File 366
PMIGPREF 823 IOA Conditions/Resources Screen 366
PMIGXPREF 823 PREV
POOL DEFINITION Option Schedule Date 579
IOA Menu 89 PREV Command
PORT Field PF10/PF22 Key 93
External Destinations Screen 290 Quick Access Panel 227, 228, 230
Portable Document Format 330 PREV Date Reference
PostScript Output Date Reference 680
PS Parameter 771 PREV Value
Postprocessing Parameters FIND Command 96
Decollating Missions 128, 422, 426 PREVCTG Command
Mission Definition 161 Decollating Mission 135
OUT Parameter 646 Mission Definition 166

Index 889
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

PREVPAGE Command Selected Pages 252

Report Viewing 248 PRINT Parameter
PREVYEAR Command WHEN Statement 131, 620
Calendar Definition Screen 405 Print parameter 342
Primary Field Print Plan
Migration Log 285 DELETE Option 327
PRIMARY MEDIA NAME Parameter Example 322
STAGE Parameter 733 Fields 323
Summary 164 Options 324
Primary Migration 734 Preparation 60
Primary Option Menu Rerun Window 322
LOG Option 86 Skip Selection Window 325
Option 5 86 Skip to Report 325
Print a Copy of the Screen 94 Stop at Report 326
PRINT CLASS Field UNDELETE Option 327
Packet Zoom Screen 302 Print Plan Screen 322
PRINT Command PRINT POST PROCESSING Status
PFKey Definition 100 Active Missions Screen 308
Quick Access Panel 230 Print Resources
Print Control STORE Parameter 161, 736
324, 326 Print Sequence
> Character 324, 326 Runtime Scheduling 830
Page Control 770 Print Status
Printers Control 326 Print Plan Screen 324
Show Options Window 194 Print Utility
Single Report 326 ISPF (Online) 410
Skip Sign 325 PRINT/CDAM PARMS
Stop Sign 327 ALLOCOPT Option 589
Print Control Char parameter 348 CAPS Command 122
Print control character parameter 347 DDNAMES Index 470
Print Control Options Decollating Mission 762
Print Plan Screen 324 Description 586
PRINT DD Statement 759 Example 590
Print Destination Generic Decollating 587
*SPOOL Value 537 Laser Printing 806
DEST Parameter 128, 161, 536 LINECT Parameter 590
node 832 ON CLASS Statement 764
ON CLASS Statement 560 Page Control Characters 770
PRINT/CDAM PARMS 833 Printing Characteristics 586
Recipient Tree 794, 832 Printing Destination 833
Search Order 834 PRINTED Status
User Report Lists 202, 204, 206, 208, 212, 217 MUST Parameter 493
userid 832 Show Options Window 193
Print Missions Field User Report Lists 219
User Report Lists 204, 217 PRINTER Parameter
PRINT MISSIONS Parameter Description 712
Print Option Window 240 Example 713
Print Monitor Mission Definition 161
MONITOR Parameter 693 Summary 646
PRINT Option Printers Control Monitor
Active Report List 221 Description 47, 60
File Transfer Control 298, 300 JCL OUTPUT Statement 762
Values of Index Panel 232 Workflow 59
Print Option Window Printing
Description 238 Batch 162, 652, 706
Immediate Printing 240 Confirmation Window 300
Parameters 239 Deferred 238

890 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Destination 833 Printing Mission Name

Immediate 238 Decollating Missions 831
Mission Status 310 Printing Mission Zoom Screen
Packet 300 External Destination 286
Reports 300 PRINTING ON dest Status
Selection Criteria 239 Active Missions Screen 308
Printing Characteristics Printing Parameters
ALLOCOPT Options 779 $SYSDATA Long Format 283
Destination 833 Bundling 642
JES3 806 CDAM 765
Logical Factors 828 Description 153
Parameters 830 LINECT 590
Physical Factors 828 Mission Specific 161, 646
PRINT/CDAM PARMS 586 PRINT/CDAM PARMS 586
PRINTING INITIALIZATION Status Printing Plan
Active Missions Screen 308 Description 47
Printing Mission Printing Speed
Batch Job 61 SORT Parameter 730
BATCH Parameter 162, 652, 706, 744 Priority
Bundling Parameters 158, 682, 729 Conditions/Resources 368
Bypassed Reports 327 Printing Sequence 830
Categories 828 PRIORITY Parameter
CATEGORY Parameter 654 Description 592, 715
Definition 57, 163 Example 592, 715
DO PRINT Statement 132, 492 Summary 160
Editing 165 Procedure Step
Example 680, 683, 687, 690, 697, 705, 711, 713, 715, 720, PROCSTEP Parameter 562
727, 731 Procstep Field
EXCLUDE USER 682 $SYSDATA Short Format 281
INTERVAL Parameter 684 PROCSTEP Parameter
MISSION Name 691 CDAM 771
MONITOR Parameter 693 ON SYSOUT Statement 561, 562
Name 831 PRODCNTL User
ON PAGE# Parameter 700 Recipient Tree 802
Organization 826 Product Description
OVERRIDE Parameter 706 CONTROL-M/Restart 41
Override Values 162 CONTROL-M/Tape 42
Packets 295 CONTROL-O 42
Parameters 153, 283, 641, 766 CONTROL-O/COSMOS 42
Print Plan 323 CONTROL-D 42
PRINTER Parameter 712 CONTROL-D/Image 42
PRIORITY Parameter 715 CONTROL-D/Page On Demand 42
Rerun Window 321 CONTROL-M 41
Runtime Scheduling 830 CONTROL-V 42
Scheduling Utility 410 CONTROLM/Analyzer 42
Screen 155 Product Integration
Single Report 326 CONTROL-V 44
SORT Parameter 729 product support 2
Start Time 316 Production Delays
Status 322, 829 MAXWAIT Parameter 548, 686
STORE Parameter 225 Productivity Tools
TASKTYPE Parameter 738 Option OA 89
TIMEOUT Parameter 744 Program Step
Workflow 59 PGMSTEP Parameter 562
Zoom Screen 316, 317 Programmer Information
Printing Mission Definition Screen SHOUT Parameter 600, 725
External Destination 286 PRT COPIES Parameter

Index 891
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

ON STATEMENT DEFAULTS 572, 576 QUICK SCHEDULE Option

PRT Value Online Utilities Menu 407
TASKTYPE Parameter 738
PRTDBG DD Statement
Copy to File 94
PRTMON# Parameter
R
BATCH Parameter 652 R Parameter
MONITOR Parameter 693 DO INDEX Statement 465
PRTSKL Member RACF 708
Batch Job JCL 653 RB Line Edit Command 838
PS Parameter RBA Range
PostScript Output Decollation 771 Active Report List 218
Values of Index Panel 232
REC Parameter
Q DO INDEX Statement 467, 469
RECFM Parameter
Q Display Type $SYSDATA Long Format 283
Active Reports List 201 Recipient Definition
Quantitative Resource Example 176
Adding 370 Parameters 176
Changing 373 PC Parameters 177
Deleting 372 RECIPIENT LEVEL Parameter 176, 793
Quantitative Resources RECIPIENT Parameter 176
IOA Conditions/Resources Screen 366 RECIPIENT LEVEL Parameter
QUANTITY Parameter Recipient Tree 176, 793
Conditions/Resources 367 RECIPIENT NAME
Queuing Mechanism Recipient Tree List 174
OSS Media 786 RECIPIENT Parameter
Quick Access Method Recipient Tree 176, 793
Description 183 Recipient Tree
Report Retrieval 70 $SYSDATA Parameter 177
QUICK ACCESS Option *FORCE Option 516, 799
Active Report List 222 Advanced Method 802
Index Window 235 Alternatives to Using 803
Quick Access Panel AUTHORIZE Field 804
Bypass 185 Bundling 682
Commands 230 CANCEL Command 179
Description 227 Check/Sort 178
Option V 246 CHKTREE Command 175
PFKeys 230 Commands 175
RETURN Command 190 CTDPARM Member 791
Return to Entry Panel 194 CTDX016 Exit 800
Stacking 226 Decollating Missions 795
User Reports Facility 825 Decollation Without 803
Values of Index Panel 231 DEF DEST Field 834
Quick Access Report List Default User 519
Description 226 Definition 171, 791
Fields 227 Description 50, 171
Option Q 227 DO USER Statement 513
QUICK ACCESS Option 227 Entry Panel 171, 328
Sort Order 200 Errors 175, 179
User Reports Entry Panel 190 Example 172, 795
User Reports Facility 825 Exit Option Window 178
Quick Ruler Definition Key Fields 793
Exit Option Window 274 FORCE Option 799
Ruler Definition Screen 265 Generic User Names 802
Toggle Key 274 INSERT Option 175

892 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Levels 791 Repeating Fields

List 172, 794 Multiple Occurrence Fields 120
Message List 175, 179 REPORT BANNER Parameter
Online Facility 793 Recipient Tree 177, 794
Operations Control 802 Report Categories
Options 174 DO MIGRATE Statement 481
Parameters 173 Report Clique
RECIPIENT NAME 174 CONTROL-D Objects Facility 329
Report Destination 794 Report Clique Change Date parameter 339
RESET Command 179 Report Clique Change Time parameter 339
Security 797 Report Clique Name parameter 339
SORT Parameter 730 report clique parameters 339
Structure Modification 793 Report Cliques
SUS2TRE Profile Variable 236 creating 811
Synonyms 796, 798 ON TRNCLASS statement 562
Syntax Checking 179 ON TRNDSN statement 563
SYSDATA Parameter 177, 794 Verifying parameters 813
Unidentified Pages 802 Report Compression
User Exit CTDX016 800 CDAM 758
Recipient Tree Definition Screen Report Decollating Mission
External Destination 286 Definition
Record Delimiter parameter 347, 351 Screen 120
Record ID Field Report Decollating Mission Definition
$SYSDATA Long Format 283 Copying to another member 138
User Report Lists 217 Deletion 111
Record Level Entry Panel 111
Index Type 65 Job List Screen 115
Record Level Index Ordering Multiple Members 111
Index, Record Level 68 Saving 111
Record-level Index Report Decollating Mission Definition Entry Panel
Mask 820 Search Window 113
Recordlevel Index Report Decollating Mission Definition Facility
Index 467 General 108
RECOVER Function Report Decollating Mission Definition facility
CTDAMUTI Utility 782 Category List Screen 117
Redisplay User Reports Report Decollating Mission Definition Mission Definition
Index Window 234 Screen
Reformatting Reports Description 120
Editing 253 Report Decollating Mission Definitions
REFRESH Command Creation 110
Report Lists 223 Report Decollating Utility
REFRESH EVERY Parameter ISPF Online 408
Recommended Value 735 Report Decollation Mission Member
STAGE Parameter 733 Creation 109
Summary 164 Report Deletion
Refresh Operation RETENTION DAYS Parameter 717
Migration 733 Report Design
Relative Byte Address 218 Indexing 820
REMARK / CCs Parameter Report Destination
Show Options Window 192 Print Destination 832
Remark Field Report Distribution
DO REMARK Statement 494 Bundle 827
User Report Lists 206, 210, 212, 216 Report Editing
Rep Field Dynamic Extraction 258
Report List Header 200 Example 253
Repeat Commands Exclude Lines Based on Strings 270
Edit Environment 837 Exit Option Window 273

Index 893
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Exiting 265 DO NAME Statement 132, 483

Quick Ruler Definition Key 265 Report Viewing 248
Ruler Edit Options 254 User Report Lists 201, 206, 213, 216
Ruler Selection 253 REPORT NAME Field
Report Encoding parameter 348 Packet Index Screen 303
REPORT Field Report Name Generation
Quick Access Report List 227 DO NAME Statement 487
Report Format parameter 339 DO REMARK Statement 498
Report Generations REPORT NAME Parameter
# OF GENERATIONS TO KEEP 650 Quick Access Panel 229
Report Identifier parameter 352 User Reports Entry Panel 188
Report Index Report Normalized Encoding parameter 348
Index 179 Report Order Message Screen
Report Information Example 138
Active Report List 764 Report Processing
Report Language parameter 348 CDAM 757
Report Lines Work Flow 756, 758
Highlighted 228 Report Retrieval
Report List Considerations 185
=X Command 223 Diagram 182
Additional Info Option 202, 210, 212, 217 Hit List Method 184
Commands 223 Index Values 181, 469, 825
Display Type 206 Index/Subindex Window Method 70, 183
Display Types 200 Indexes 70, 180
Entry Panel 186, 198 Logic 183
Fields 206 Methods 183
FIND Command 223 Multiple Reports 226
Header Line 199 Options 182
Option P 238 Quick Access Method 183
Options 221 Quick Access Panel 227, 228
Quick Access 201 Selection Criteria 64, 188, 194
Search Continuation Window 219 Wait Message 247
SEARCH Parameter 514 Report Sections
Selection Criteria 64, 188, 194 Page Ranges 239
SHOW Command 191 Report Status
SORT Command 225 Show Options Window 193
Sort Order 199, 200 User Report Lists 218
Status 218 Report Viewing
User Display Type 206 Capabilities 179
User Reports Entry Panel 186, 198 Commands 248
Report List Fields Description 64
All Fields Display Type 216 EDIT Command 249
Default Display Type 201 Edit Command 256
Job Display Type 209 Example 246, 261
Long Display Type 213 Functions 179
Quick Access Display Type 201 Header Fields 248
SDSF Display Type 211 LOCNOTE Command 278
Report List Print Window LOCVAL Command 250
External Destination 286 Migrated Reports 247
Report Migration Online Facility 246
Migration ... 241 Printing Control Characters 194
REPORT NAME Quick Ruler Definition Key 265
Print Plan Screen 323 Report Editing 253
Report Editing 254 Rulers 258
Sort Key 729 Selection by Line Content 266
Report Name SHOWCC Command 249
Concatenation 487 SHOWNOTE Command 278

894 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

SHOWPAGE Command 249 Resource Window

SPAGE Command 250 Conditions/Resources 373
Tag Notes 276 Resources
User Reports Facility 179 CONTROL-D Objects Facility 358
VALUE Command 249 RESOURCES Parameter
Values of Index Trigger 231 Conditions/Resources 369
Wait Message 247 RESTARTED Status
Reporting Facility Active Missions Screen 309
Summary 53 RESTORE IN PROCESS Status
Reports Database Active Missions Screen 309
CDAM 777 Restore Mission
Reports Facility CATEGORY Parameter 654
User Reports... 180 Cyclic 532, 684, 739, 740
Repository Editing 165
CONTROL-V 48 Example 685, 740, 742
Description 47 History Report List 222, 240
REQUEST Parameter INTERVAL Parameter 684
For Future Use 641, 647 Parameters 153, 641, 684, 738
REQUESTED CHANGE Status Scheduling Utility 413
Active Missions Screen 307 Screen 157
REQUESTED FREE Status TASKTYPE Parameter 738
Active Missions Screen 307 Workflow 62
REQUESTED HELD Status Zoom Screen 317, 320
Active Missions Screen 307 Restore Mission Field
REQUESTED RERUN Status User Report Lists 217
Active Missions Screen 307, 321 Restore Mission field
RERUN Option $SYSDATA Long Format 282
Active Missions Screen 312 RESTORE Option
Rerun Window History Report List 222
Active Missions Screen 312, 322 Restore Utility
Printing Mission 322 ISPF 413
Reserved Word Restore Window
DDNAMES 463 History Report List 240
RESET Argument Restored Only Status
SPAGE Command 251 Show Options Window 193
RESET Command Restored Status
Column Editing 266 User Report Status 219
Decollating Mission 133, 165, 835 Restricting Displays
Description 98 Tracking and Control 708
IOA Log Show Screen Window 390 Resulting Line
PFKey Definition 93 Edit Report Columns 262
Recipient Tree Exit 179 Retention Date Field
RESIDENT Field $SYSDATA Short Format 281
Index Window 234 Retention Days Field
Resident Index $SYSDATA Long Format 284
DO INDEX Statement 465 RETENTION DAYS Parameter
Flag 234 AGE Parameter 733
Planning 822 Description 717
Report Sections 189 FORCE Parameter 723
Resource Control REFRESH EVERY Parameter 735
Archive Server 785 STAGE Parameter 733
Resource Management Summary 646
Archive Server 785 RETENTION PERIOD
Resource Ownership Type Packet Zoom Screen 301
Conditions/Resources 367 Retention Period
Resource Sets DO BACKUP Statement 452
CONTROL-D Objects Facility 354 DO MIGRATE Statement 481

Index 895
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

FORCE Parameter 723 RULER Parameter

Modification 717 Print Option Window 240
RETRANSMIT Option RULER Show Mode
File Transfer Control 298 Toggle Command 223
RETRIES Field RULER TYPE Parameter
Packet Zoom Screen 302 Exit Option Window 274
Retrieval Criteria Report Editing 253
Selection Criteria 369 Rulers
RETRIEVE Command Checking 265
PF12 Key 93 Column Editing 261, 265
PFKey Definition 93 Commands 275
RETRO Parameter Copy a Ruler 253
Description 594, 719 Definition 253
Example 595, 720 Dynamic Extraction 258
MAXWAIT Parameter 686 EDIT Command 249, 256
MINIMUM Parameter 552, 689 Edit Options 254
PDS Parameter 584, 710 Exit Option 273
Schedule after ODATE 126, 159 Global 276
RETURN Command Page Mode 249, 276
Quick Access Panel 226, 230 Quick Ruler Definition Key 274
User Reports Entry Panel 194, 223 Report Viewing 248, 265
RETURN Option Screen Editing Rules 253
Active Missions Screen 321 Selection Criteria 253
RIGHT Command Show Page Mode 249
Report Viewing 248 Tag Notes 276
RL Line Edit Command 837 VIEW Option 221
RLSE Parameter Run Date and Time
CDAM Logic 776 User Report Lists 203, 208, 212, 216
ROSCOE/ETSO Runtime Environment
Address Space 81 CONTROL-M/Analyzer 460
Environment 50 Runtime Scheduling
Wait Message 247 Decollating Missions 127, 421, 426
Rotation parameter 341 Mission Definition 160
row columnized page Parameters 640, 645
transformation of binary reports 809 Printing Missions 830
Row commands
IOA Editor 103
RR Line Edit Command 838
RS Line Edit Command 837
S
RST Value S
TASKTYPE Parameter 738 Category Option Category List Screen, Migration,
RULE ACTIVITY Option Printing, Backup, Restore Mission Definition 151
Primary Option Menu 89 Category Option Category List Screen, Report
RULE DEFINITION Option Decollating Mission Definition 119
IOA Menu 89 S Option
Primary Option Menu 89 Display Filters Window 385
RULE STATUS Option S Parameter
IOA Menu 89 DO USER Statement 514, 519
RULER Command SAVE (Y/N) Field
Active Report List 223, 275 IOA Log Show Screen 386
Ruler DEFAULT SAVE Command
Report Viewing Screen 275 Notepad Facility 244
Ruler Definition Packet Zoom Screen 302
Exiting 273 Zoom Screen 320
RULER NAME Parameter SAVE Field
Exit Option Window 274 IOA Log Show Screen Window 386
Report Editing 253 SAVE Option

896 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Recipient Tree 178 $SYSDATA Short Format 280

SAVE Ruler Option Active Missions Environment 304
Exit Option Window 274 Active Missions Show Options Window 309
Saving Backup/Migration Utility 412
Decollating Mission 135 Calendar Definition 399
Mission Definitions 166 Calendar Facility 391
Ruler Definitions 265 Calendar Facility Entry Panel 392
Saving Missions Calendar List 393
Category List Screen, Printing, Backup, Restore Category List 117, 149
Missions 143 Color Lines Based on Strings 270
SB37 Abend Conditions/Resources 370, 372
CDAM 757 Confirm Override 325, 326
Scan Origin point parameter 353 Confirm Print Window 300
SCHED Command CONTROL-D Objects Entry Panel 328
Display Toggle 123, 153 CONTROL-D Report Clique Definition 332
Scheduling Parameters 153 CONTROL-D Reports Cliques List 330
Schedule Date CONTROL-D Resource Sets List 355
IN Parameter 528, 679, 703 CONTROL-D Resources List 356, 359, 361
OUT Parameter 579 Decollating Mission 123, 419, 472
Schedule Validation Edit Report Columns 261
CONFCAL Parameter 425, 433, 659 Edit Report Lines and Columns 255, 257, 260
SCHEDULED RUN DATE Field Exclude Lines Based on Screens 270
Backup/Migration Utility 412 External Destinations 287
Printing Mission Utility 410 File Transfer Control 294
Report Decollating Utility 409 History Report List 240
Restore Mission Utility 413 Include Lines Based on Strings 266
Scheduling Index Window 234
Boolean Logic 662 IOA Entry Panel 84
Calendar Facility 390, 399 IOA Help 98
Criteria Display 153 IOA Log 93, 379
Decollating Mission 123, 409 IOA Log Show Screen Window 385
Logic 425, 644 Is Waiting For 312
Manual 167 Job List 115
Migration Mission 642 Log Screen 91, 315, 379
Migration Stages 159 Manual Conditions 374, 376, 378
Parameter Display 153 Message List 175, 179
Printing Mission 410 Migration Mission 154, 636
SCHED Command 153 Migration Zoom 318
Validation 425, 434, 659 Migration, Printing, Backup, Restore Mission
Scheduling Parameters Definition 140
Display 145 Migration, Printing, Backup, Restore Mission
Screen Control Definition Entry Panel 144
Online Facility 108 Mission Definition 152
Screen Description Line Mission List 147
Online Facility 92 Mission Order Messages 169
Screen Exit Notepad Window 243
CANCEL Command 98 Online Utilities 407
Screen Layout Online Utilities Menu 407
Online Facility 91 Packet Index 302
Screen Printing Packet Zoom 301
ISPF LIST File 100 Prerequisite Condition Utility 415
Screen Transfer Primary Option Menu 85, 87
TSO CTMTTRA Command 108 Print Mission Utility 410
Screen Usage Line Print Plan 322
Screen Layout 91 Quick Access Panel 227
Screens Quick Access Report List 226
$SYSDATA Long Format 282 Recipient Definition 176

Index 897
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Recipient Tree Entry Panel 171 Migration Mission 722

Recipient Tree List 172 SECONDARY SKELETON Parameter 722
Report Decollating Mission Definition Entry Panel 111 STAGE Parameter 734
Report Decollating Mission Definition Facility 109 Summary 164
Report Decollating Utility 409 Secondary Migration 734
Report Editing 253 SECONDARY SKELETON Parameter
Report Editing Exit Window 273 Description 722
Report Order Messages 138 Summary 163, 646
Report Viewing 246, 258, 260 SECPREF Parameter
Restore Mission Utility 413 Secondary Migration 734
Rule Definition Entry Panel 145 SECPREF parameter 824
Search Continuation Window 219 Security
Show Option Window 299 OWNER Parameter 582, 708
Show Options Window 191 Recipient Tree 797
Skip Selection 325 Recipient Tree Bypass 804
Tag Note Window 276 SEE/HIDE PARENT Option
TSO Command Processor 106 Recipient Tree List 175
User Report Lists 201, 202, 205, 209, 210, 212, 214, 217 SELECT BY Fields
User Reports Entry Panel 186, 194 User Reports Entry Panel 196
User Reports Facility 180 SELECT BY STATUS
Values of Index Panel 231 Show Options Window 193
Why Screen 312 SELECT Command
Year List 394 Member Creation 109
Zoom Screen 316 Mission Creation 141
SCROLL Command SELECT Option
PFKey Definition 93 Calendar List Screen 394
Scrolling Display Filters Window 385
Commands 95 External Destinations Screen 289
Quick Access Panel 228 Index Window 235
Scrolling Amount Job List 111, 116
CRSR 95 Mission List 142, 148
HALF 95 Recipient Tree List 174
MAX 95 Subindex Window 236
PAGE 95 Values of Index Panel 229
SDSF Display Type Year List Screen 396
Fields 211 SELECT Option Category List Screen, Migration, Printing,
User Report List 210 Backup, Restore Mission Definition 151
Search Continuation Window SELECT Option Category List Screen, Report Decollating
User Report List 219 Mission Definition 119
Search Direction Select Pages Command
Active Missions List 310 SPAGE Command 250
SEARCH Parameter Selected Pages Print Option Window
Decollating Mission 832 Parameters 252
DO USER Statement 514, 519 Selection Criteria
Printing Destination 834 Active Missions Screen 310
Search Window CD message type 387
Migration, Printing, Backup, Restore Mission Conditions/Resources 369
Definition Entry Panel 145 File Transfer 299
Report Decollating Mission Definition Entry Panel 113 Include/Exclude 270
Search Windows Line Content 267
WHEN Statement 624 Report Retrieval 70
Searching Rulers 253
FIND Command 96 User Report Lists 188, 191, 199
LOCATE Command 95 User Reports 64
Secondary Field Selection Window
Migration Log 285 Print Plan Screen 325
SECONDARY MEDIA NAME Parameter SEND WITH CC

898 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

External Destinations Screen 290 Show Options Window 194

SEQL=filename SHOW LIMIT ON Field
Output to File 655 Log Screen 380
Sequence of Printing SHOW MIGRATED Parameter
Runtime Scheduling 830 User Reports Entry Panel 189, 198
SET Show Options Window
CAPS Command 122 Active Missions Screen 305, 309
SET command 104 Description 191
SET Command Panel Example 191
End TRACE level 104 File Transfer Control 299
Set Dollar Sign Representation 105 Parameters 192
Set Language Preferences 106 REMARK/CCs Field 495
Set TRACE level 104 Show Control Chars 249
Set Dollar Sign Representation User Reports Entry Panel 194
SET Command Panel 105 Show Page Mode
SET Field Rulers 249
DO SET Statement 500 Show Rulers Parameter
Set Language Preferences Show Options Window 193
SET Command Panel 106 Show Scheduling Criteria
Set TRACE level Decollating Entry Panel 123, 125
SET Command Panel 104 Show Screen Filter
Shadowing parameter 341 All IOA Products 388
Shadowing Style parameter 341 Log Screen 388
Shared Devices Show Screen Filter Window Field
Archive Server 787 DESC 386
Shared Resource SHOWCC Command
WAIT SCHEDULE Status 371 Control Characters Mode 249
SHIFT Parameter Report Viewing 249
CONFCAL Parameter 126, 159, 433, 644, 659 SHOWNOTE Command
Decollating Missions 425 Red/Yellow Toggle 278
SHIFT Value SHOWPAGE Command
Scheduling Date 433, 659 Report Viewing 249
Shout Facility SHPF Command
DO SHOUT Statement 509 PFKey Assignment 93
Overview 54 PFKey Definition 93
Parameters 599 Quick Access Panel 230
Variables 847 Show PFKey 93
Shout Message SIMUL/TAPE PULL Option
DO SHOUT Statement 132 Online Utilities Menu 407
SHOUT Parameter Skeleton Job
Decollating Missions 426 Migration Mission 723
Description 599, 724 SKELETON Parameter
DO SHOUT Statement 511, 602 BATCH Parameter 652
Example 603, 727 Summary 162
Message Generation 646 Skip to Report Option
SHOUT Messages 128, 160 Print Plan Screen 325
WHEN LATE 599, 724 SKL Library
SHOW Command BATCH Parameter 652
Active Environment Screen 384 SMF Records
Active Missions Screen 309 Recipient Level Billing 61
Active Report List 223 SMIGXPREF file prefix 824
File Transfer Command 299 SMS Environment
IOA Log Screen 381 CDAM 773
Log Screen 383 SOLVLVC Profile Variable 250
PFKey Definition 93 SORT Command
Show Options Window 191 Parameters 225
Show Control Chars Parameter User Report List 224

Index 899
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

SORT FIELDS Field Color Code 305

Sort Parameters Window 224 STAT Command
SORT Key Category List Screen, Printing, Backup, Restore
Bundling Parameter 158, 729 Mission Definition 151
Sort Order Category List Screen, Report Decollating Mission
Default 225 Definition Facility 119
Index Size 69, 824 Job List Screen 396
Report Lists 199, 730 STAT Date Reference
SORT Parameter OUT Parameter 579
CTDX020 Exit 729 STAT Field
Description 729 Conditions/Resources 369
Example 730 STAT Parameter
Printing Missions 829 DO COND Statement 455, 456
SORT Keys 158, 729 IN Parameter 528, 679, 703
Sort Parameters Window STATE Parameter
Bypassing 225 Mission Status 311
Example 224 Statistical Information
Space Allocation Job List 115
CDAM 757, 775, 777 Mission List 147
Space Utilization Status
CDAM 765 User Report Lists 213
SPAGE Command STATUS Field
Print Option Window 252 Active Missions Screen 306
Report Viewing 250 Status Field
Special Character Field $SYSDATA Long Format 283, 285
Edit Lines Screen 259 Migration Log 285
SPLIT Command User Report Lists 202, 206, 210, 212, 216, 218
PF02/PF14 100 Status Selection Criteria
PFKey Definition 93 Active Missions Screen 310
Split Screen Mode Status Values
Online Facility 99 Active Missions Screen 307
Split Words parameter 342 Print Plan Screen 324
SPOOL Stop at Report Option
ON STATEMENT DEFAULTS 537, 573 Print Plan Screen 326
Spool Decollation STORE Parameter
Description 805 ACIF Parameter 764
SPOOL Sysout Active User Report List 225
ON Statement 563 Description 161, 736
Spool Utilization Summary 647
CDAM 757 STORED Command
SPOOL Value Displaying Stored Reports 225
DEST Field 833 Stored Reports
ON STATEMENT DEFAULTS 575 Displaying 225
Unidentified Pages 536 STRING
Stage Number CAPS Command 122
Migration Path 733 String Comparison
Stage of Migration Color Lines Screen 271
Scheduling Parameters 642 Comparison Operators 267
STAGE Parameter Include Lines Screen 267
Description 733 Operators 268, 623, 625
Example 735 Prefixing and Masking 83, 84
Summary 164, 647 STRING Parameter
STARTED AT Field WHEN Statement 622
Zoom Screen 316 String Search
Started Date and Time FIND Command 223, 233, 248
User Report Lists 209 LOCATE Command 96, 233
Started Status String/Line/Column Flag

900 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Color Lines Screen 272 Migrated Report 284

Subindex Short Format 281
DO INDEX Statement 462, 468 Viewing 279, 286
Quick Access Panel 825 SYSID Parameter
Values of Index Panel 231 $SYSDATA Long Format 283
Window 232, 235 SYSJCL ON Statement
SUBINDEX Parameter ON SYSJCL Statement 560
DO INDEX Statement 468 SYSLOG Generated Files
Subindex Window WHEN IN QUEUE Parameter 629
Description 235 SYSLOG ON Statement
Fields 236 ON SYSLOG Statement 560
Hit List 185 SYSMSG ON Statement
Index Path 232 ON SYSMSG Statement 560
Method 183 SYSOPT Variable
Options 236 CONTROL-M/Analyzer 459
Report Retrieved 183 Sysout Allocation Mode
SUBSYS Option BATCH Parameter 652
JCL Syntax Rules 760 SYSOUT Archiving
SUBSYS Parameter Display Type J 186
Activating CDAM 759 Sysout Class
CDAM Datasets 781 $SYSDATA Long Format 283
CDAM Decollation 806 SYSOUT ON Statement
PRINT/CDAM PARMS 586 ON SYSOUT Statement 560
SUBSYS=CDAM Parameter SYSOUT Parameter
FORMDEF Parameter 762 CDAM 760
PAGEDEF Parameter 762 Sysout Printing
support, customer 2 Cyclic Printing 739
SUS2SRTI Parameter System Datasets
User profile 200 ON Statement 561
User Report Sort Default 225 System Date
SUS2TRE Profile Variable Description 73
Recipient Tree 236 Shout Facility 847
SUSPENDED Status SYSTEM ID Parameter
Active Missions Screen 307 User Reports Entry Panel 198
SUSRDELW Profile Variable System Variables
Confirmation Window 222 Shout Facility 847
SUSRVEW Parameter
User profile 202
SWAP Command
PF09/PF21 100
T
SYNONYM Parameter T Parameter
DO USER Statement 514 DO USER Statement 514
Recipient Definition 177 Tag Notes
Recipient Tree 793, 796, 798 Notepad Facility 241
Synonyms PF06 Key 276
Recipient Tree 175, 796 Report Viewing Screen 276
Syntax Check Tagged Columns
Decollating Mission 135, 836 PF06 Key 277
Recipient Tree 178 Tagged Substrings
SysCatalog Name parameter 352 Red, Yellow or Highlighted 277
SYSDATA Entry Target Media
Printing Characteristics 779 Migration Mission 733
SYSDATA ON Statement STAGE Parameter 733
ON SYSDATA Statement 560 TASK TYPE Field
SYSDATA Record Log Screen Filter 388
Active Report List 764 TASK TYPE Parameter
Long Format 282 Active Missions Screen 311

Index 901
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Show Screen Filter 388 DO SHOUT Statement 509, 510, 601, 726
TASKTYPE Parameter SHOUT Parameter 600, 725
Cyclic Decollating 524 TO PAGE Parameter
Description 604, 738 Print Option Window 239
ERP 125 Tocol Parameter
Example 605, 740 FIND Command 96
REP 125 Toggle Keys
Summary 125, 158 Quick Ruler Definition Key 265, 275
Tracking and Control 738 TOP SECRET 708
technical support 2 TotRec Field
Terminal Support User Report Lists 212
Online Facility 82 TOPAGE Argument
Termination Status SPAGE Command 251
DO NOTOK Statement 490 Transfer Command
Text Orientation parameters 340 Multi-screen Control 90
Text report TRANSFER END Field
Checking and adjusting with transformation 815 Packet Zoom Screen 302
Text Report Clique parameters 348 Transfer of Control
Text Reports TSO/Online Facility 107
CONTROL-D Report Clique Screen 332 Transfer Packet
Text reports 330 HELD State 302
TIME Decollated Index Files 298
Packet Index Screen 303 TRANSFER START Field
TIME Field Packet Zoom Screen 302
Index File Name 823 Transfer Status
Log Screen 380 File Transfer Control 297
TIME FROM Parameter File Transfer Show Option Window 299
User Reports Entry Panel 197 Packet Zoom Screen 301
TIME FROM/TO Parameter Transfer to TSO Command
Show Options Window 193 PFKey Definition 93
TIME INTERVAL Transfer to Utilities Screen Command
INTERVAL Parameter 532 PFKey Definition 93
TIME Parameter TRANSFERRED Date and Time
CDAM 772 File Transfer Control 297
Description 607, 741 Transformation
Example 607, 741 Checking and adjusting a text report for 815
Summary 160 Creating a decollation mission with 811
Time Range Creating a text report with 813
Show Options Window 193 Creating Report Cliques 811
TIME Parameter 607, 741 Defining the final decollation definition 816
TIME TO Parameter Implementing decollation with 810
User Reports Entry Panel 198 Verifying Report Clique parameters 813
TIME/DATE Verifying the final version of the report 817
Sort Key 730 viewing HTML format 813
TIMEOUT Parameter Viewing Normalized Reports using CONTROL-
Description 744 D/WebAccess Server 812
Example 744 viewing PDF format 812
Summary 162, 647 transformation
Timestamp of print stream reports 808
Overriding 677 transformation of binary reports
TIMESTAMP Field CONTROL-D Resource Manager 809
Zoom Screen 316 normalized page 809
TO BE DELETED Field row columnized page 809
Migration Log 285 TRANSMISSION ERROR Status
TO BE SUSPENDED Status File Transfer Control 297
Active Missions Screen 307 TRANSMIT Parameter
TO Destination Recipient Definition 178

902 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

TRANSMITTED Status UNIDENT User

File Transfer Control 297 Recipient Tree 802
TRANSMITTING Status Unidentified Pages
File Transfer Control 297 DEST Parameter 536
TRANSTO Parameter LVL Parameter 538
AFPDS Report 772 Printing Destination 833
TRC character used parameter 347, 348 Recipient Tree 802
TRC Parameter USER Parameter 542
$SYSDATA Long Format 283 UNIT Parameter
OPTCD=J Parameter 763 CDAM 772
Sysout Control 763 CDAM File 772
TREE Universal Character Set
Sort Key 730 UCS 283
TREE Parameter Unix Environment
CONTROL-D Procedure 172 CONTROL-D for Distributed Systems 239
CTDPRINT Procedure 172 DEF DEST Parameter 177
Trigger Mission Unused Tracks
NOT LATER THAN 697 MINIMUM Parameter 552, 689
TSO PDS Parameter 584, 710
Commands 106 UP Command
Control 108 PF07/PF19 95
Control Transfer 93 PFKey Definition 93
Environment 50 Quick Access Panel 228
Screen 106 UPDATE Command
Wait Message 247 Notepad Facility 244
TSO Application UPDATE Option
Online Facility 107 $SYSDATA Records 286
TSO CTMTTRA Command External Destinations Screen 289
Transfer to IOA 107 User Report Lists 222
TSO Option URGENCY Parameter
Primary Option Menu 87 DO SHOUT Statement 510, 511
TSO SEND Command Show Screen Filter 388
DO SHOUT Statement 510 URGN Parameter
SHOUT Parameter 601, 726 SHOUT Parameter 601, 726
TSO Transfer Command Usage Line
PKFey Definition 93 Screen Layout 92
TSO/ISPF 81 Use EOT Fonts parameter 344
Environment 50, 81 USE Parameter
TYP Field Conditions/Resources 368
Active Missions Screen 306 Use PFR Fonts parameter 344
TYPE Field User Recipient
Conditions/Resources 367 Recipient Tree 50
External Destinations Screen 289 USER BANNER Parameter
Manual Conditions 375 Recipient Definition 177
TYPE Parameter Recipient Tree 794
DO USER Statement 515 User Display Type
Additional Info Option 207
Fields 206
U User Report Lists 205
User Entry
UCS Parameter Active Report List 764
$SYSDATA Long Format 283 User Exit
CDAM 760 CTDX007 626
UNCONDITIONAL Distribution CTDX016 515, 800
TYPE Parameter 514 CTDX018 769, 780
UNDELETE Option CTDX018O 779
Print Plan Screen 327 CTDX020 730

Index 903
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Sample 61 Display Type V 186

Sort Code E 730 Example 187
User Field Online Viewing 64, 180
Quick Access Panel 229 Options 198
Quick Access Report List 227 Panel Access 194
Report List Header 200 Parameters 188
User ID Quick Access 194
$SYSDATA 279 REMARK/CCs Field 495
Active Missions Screen 306 RETURN Command 194
Default for Rulers 254 Return from Quick Access 230
DO USER Statement 131 Show Options Window 191
Online Facility 85 User Reports Facility
USER INTERFACE Option Online Screens 180
Online Utilities Menu 407 User Screen
USER Name User Report List 200
Print Plan Screen 323 USERID Field
User Name Log Screen 380
DO USER Statement 513 Log Screen Filter 388
File Transfer Control 297 Report Destination 832
File Transfer Show Option Window 299 USERID Parameter
Generic 516 Active Missions Screen 311
Packet Zoom Screen 301 USERID Value
Report Editing 254 DO SHOUT Destination 509
Sort Key 729 SHOUT Parameter 600, 725
User Report Lists 201, 216 USERID Variable
USER Parameter %%USERID Variable 517
Description 542 USERLIST Function
Example 542 CTDX004 User Exit 805
JOB DEFAULTS 542 UTICOPY DD Statement
ON STATEMENT DEFAULTS 572 CTDAMUTI Utility 782
ON Statement Defaults 574 Utilities
User Reports Entry Panel 188 Backup 411
User profile CLIST IOAUTIL 407
Customization 81 Conditions/Resources File 415
Default Color Definitions 246 CTDAMUTI 778, 781
SUS2SRTI Parameter 200 CTDCLHIS 648
User Report List Decollating 408
Active Report List 48 Fast Transfer 408
History Report List 48 IOALDNRS 374
Permanent Report List 48 Maintenance 781
Report List 48 Migration 411
Search Continuation Window 219 Prerequisite Condition 415
SORT Command 224 Print 410
Sort Order 200 Restore 413
User Reports Under ISPF 407
DISPLAY Command 223
Dynamic Extraction 258
Entry Panel 190
Online Viewing 179
V
Restoring 240 VALUE # OF SECTIONS Field
SHOW Command 191 Values of Index Panel 232
User Reports Entry Panel VALUE Command
BYPASS PANEL Field 190, 194, 227 Report Viewing 249
DATE FROM=LAST 188 VALUE Field
Description 186 Quick Access Panel 229
Display A 194 VALUE Parameter
Display J 195 User Reports Entry Panel 190

904 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Value Selection
Values of Index Panel 232 W
Values of Index Panel Wait Backup Only Status
Based on Index Value 189 Show Options Window 193
Description 231 Wait Bkp Status
Display Selected Index 235 User Report Lists 219
First Value 190 Wait Decollation Status
Index Design 68 Show Options Window 193
Index Window 234 User Report Lists 219
Option V 246 WAIT FOR JOB Status
Options 232 Active Missions Screen 310
Quick Access Panel 228, 231 WAIT FOR PRINTER Status
User Reports Entry Panel 231 Active Missions Screen 310
Via Quick Access Panel 228 Wait Message
VAR format Migrated Report Viewing 247
Index definition 65, 463 WAIT MIGRATE Status
VAR Parameter User Report Lists 219
DO INDEX Statement 466 WAIT PRINT Status
Variable Database Option MUST Parameter 493
Primary Option Menu 88 Show Options Window 193
Variables User Report Lists 219
Shout Facility 847 WAIT PRINTING Status
used with DO statements 503 PC Transfer Packet 295
VAULT DEFINITION Option WAIT PROCESS Status
IOA Menu 89 Active Missions Screen 307
Verifying Report Clique parameters Wait Restore Only Status
transformation 813 Show Options Window 193
Version Information Wait Restore Status
Primary Option Menu 90 User Report List 219
View Indicator WAIT SCHEDULE Status
User Report Lists 202, 206, 210, 216 Active Missions Screen 307
VIEW Option CONTROL Resources 371
$SYSDATA Records 286 Why Screen 312
Active Report List 221 Wait Status
Ruler Editing 222 Color Codes 305
Values of Index Panel 232 WAIT TRANSMISSION Status
View Value File Transfer Control 297, 298
BYPASS PANEL Parameter 191 WAITING FOR JOB Status
Viewing Active Missions Screen 308
Report Viewing 64, 180 WAITING FOR PRINTER Status
Viewing the final version of a report Active Missions Screen 308
Transformation 817 WCAL Parameter
Volume Field Calendar Name 611
Migration Log 285 Calendar Type 613, 749
Volume Prefix Decollating Missions 424
STAGE Parameter 734 WDAYS Parameter 126, 159, 644, 746
Volume Set WD2104 Wish
FileTek Storage Machine 734 Print Mission 493
VOLUMES Parameter WDAYS Parameter
CDAM File 772 AND/OR Logic 126, 159, 665
VSET Parameter DATES Parameter interaction 647
STAGE Parameter 734 Days of the Week 159
Summary 164 Description 610, 644, 746
VTAM 81 Example 614, 750
Environment 50, 94 Format 747
VTAM Printer Name 239 Logic 611, 613, 749
MINIMUM Parameter 552, 689

Index 905
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

Negative Value 613, 749 Mission List ODATE 168

PDS Parameter 584, 710 Notepad 243
Valid Formats 611 Notepad Confirm 246
WCAL Parameter 644, 746 Notepad Exit 246
Weekend Processing Override Confirm 325, 326
Printing Missions 831 Override Print Plan 325
WHEN Print Option 238
used with DO SET 503 Print Plan 322
WHEN IN QUEUE Parameter Print Plan Override 325
CDAM 770 Recipient Tree Exit 178
Description 628 Reprint 322
Example 630 Rerun 322
WHEN LINE Resource Quantity 373
CAPS Command 122 Restore History 240
WHEN Parameter Ruler Exit 273
SHOUT Parameter 599, 724 Search Continuation 219
WHEN Statement Selected Pages Print Option 252
Description 619 Selection Skip 326
DO USER Statement 513 Show Screen Filter 388
Example 520 Skip Print Plan 326
ON STATEMENT DEFAULTS Interaction 573 Skip Selection 326
Recipient Tree 799 Sort Parameters 224
WHEN VAR Subindex 235
CAPS Command 122 Tag Note 277
WHY Option Zoom Exit 321
Active Missions Screen 312 Windows NT Environment
Why Screen CONTROL-D for Distributed Systems 239
Adding Conditions 313 DEF DEST Parameter 177
Confirmation Window 314 with transformation 813
Description 312 Work Flow
Wildcard Characters CDAM 758, 775
Masking 83 CONTROL-D/WebAccess Server 296
Window Exit CONTROL-V 756, 758
RESET Command 98 Report Retrieval 182
Windows Workflow
ADD Conditions 370 Backup 61
Category List Exit 167 Decollating 56
Conditions/Resources Delete 372 Migration 58
Confirm Notepad 246 Printing 59
Confirm Override 325, 326 Restore 62
Delete Conditions/Resources 372 Working Date
Delete Job 117 Description 73
Delete Mission 149 Working Days
Exit Category List 136, 167 CONFCAL Parameter 433, 659
Exit Notepad 246 DAYS Parameter 438
Exit Recipient Tree 178 WDAYS Parameter 610, 748
Exit Ruler 273 Workload Considerations 831
Exit Zoom 321 WRAP Command
Give To 236 WRAP Mode 250
Index 234 WRITER Field
IOA Log Show Screen Window 385 Confirm Print Window 300
Job Deletion 117 Writer Name
Job List ODATE 138 %%EXTWTR Function 516
Log Show Screen 388 Writing Reports to File
Manual Condition Add 376 CDAM 757
Manual Condition Delete 378 WTR Field
Mission Deletion 148 $SYSDATA Long Format 283

906 CONTROL-D and CONTROL-V User Guide

 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

X
X Command
Online Facility Exit 91
Primary Option Menu 87
X Offset parameter 344
Xerox 8700/9700 Printers
User Exits 60
XEROX Reports
CONTROL-D Report Clique Screen 336
XMLSEP
CAPS Command 122
XMLSEP Installation Parameter
CDAM 772
XMLSEP Parameter
CDAM File 772
XResolution parameter 344
XRX Reports
CONTROL-D Report Clique Screen 336

Y
Y Offset parameter 344
YEAR Field
Calendar Definition 399
Calendar Facility Entry Panel 393
Year List Screen 394
Commands 395
Exiting 405, 406
Inserting New Year 397
Year List Screen, IOA Calendar Facility
Format 395
YResolution parameter 344

Z
ZOOM Option
Active Missions Screen 312
File Transfer Control 298, 301
Zoom Screen
Confirmation Window 320
Description 316
Exiting 320
File Transfer 301
Migration Mission 316, 318
Modifying Parameters 320
Restore Mission 320

Index 907
 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

908 CONTROL-D and CONTROL-V User Guide

Notes
*94576*
*94576*
*94576*
*94576*
*94576*