CONTROL-M Job Parameter and Variable …

1 control -MJob Parameter and VariableReference GuideVersion 31, 2004 Copyright 2004 BMC Software, Inc., as an unpublished work. All rights Software, the BMC Software logos, and all other BMC Software product or service names are registered trademarks or trademarks of BMC Software, Inc. IBM is a registered trademark of International Business Machines Corp.; Oracle is a registered trademark, and the Oracle product names are registered trademarks or trademarks of Oracle Corp. All other registered trademarks or trademarks belong to their respective USE AND CONTENTS OF THIS DOCUMENTATION ARE GOVERNED BY THE SOFTWARE LICENSE AGREEMENT ENCLOSED AT THE BACK OF THIS Rights GOVERNMENT RESTRICTED RIGHTS. UNPUBLISHED RIGHTS RESERVED UNDER THE COPYRIGHT LAWS OF THE UNITED STATES.

2 Use, duplication, or disclosure by the Government is subject to restrictions set forth in FAR Section Alt. III (g)(3), FAR Section , DFARS (b), or DFARS , 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 BMC SoftwareYou can access the BMC Software Web site at From this Web site, you can obtain information about the company, its products, corporate offices, special events, and career opportunities. United States and CanadaOutside United States and CanadaAddressBMC Software, CityWest TX 77042-2827Te l e p h o n eFax(01) 713 918 8800(01) 713 918 8000Te l e ph o ne713 918 8800 or800 841 2031 Fax713 918 8000 BMC Software, Inc.

3 , Confidential and Proprietary InformationiiiCustomer SupportYou can obtain technical support by using the Support page on the BMC Software Web site or by contacting Customer Support by telephone or e-mail. To expedite your inquiry, please see Before Contacting BMC Software. Support Web SiteYou can obtain technical support from BMC Software 24 hours a day, 7 days a week at From this Web site, you can read overviews about support services and programs that BMC Software offers find the most current information about BMC Software products search a database for problems similar to yours and possible solutions order or download product documentation report a problem or ask a question subscribe to receive e-mail notices when new product versions are released find worldwide BMC Software support center locations and contact information, including e-mail addresses, fax numbers, and telephone numbersSupport by Telephone or E-mailIn the United States and Canada.

4 If you need technical support and do not have access to the Web, call 800 537 1813. Outside the United States and Canada, please contact your local support center for assistance. To find telephone and e-mail contact information for the BMC Software support center that services your location, refer to the Contact Customer Support section of the Support page on the BMC Software Web site at Contacting BMC SoftwareBefore you contact BMC Software, have the following information available so that Customer Support can begin working on your problem 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 levelBMC Software, Inc.

5 , Confidential and Proprietary InformationivCONTROL-M Job Parameter and Variable reference guide sequence of events leading to the problem 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 BMC Software, Inc., Confidential and Proprietary InformationContentsvContentsContentsAbou t This Book .. xviiChapter 1 IntroductionDefining Job Processing parameters .. 1-2 Job Parameter and Variable Access .. 1-3 Language Support .. 1-6 Conventions for Parameter Descriptions .. 1-6 Chapter 2 General ParametersApplication .. 2-4 Application Node Group .. 2-6 Application Type.

6 2-8 Application Version .. 2-10 Author .. 2-12 AutoEdit Assignment .. 2-14 Command .. 2-20 control Module (CM) Version .. 2-23 CONTROL-M .. 2-25 Description .. 2-27 Doc Lib .. 2-29 Doc Mem .. 2-31 File Name/Mem Name .. 2-33 Form Name .. 2-36 Group .. 2-38 Job Name .. 2-40 Over Lib .. 2-42 Owner .. 2-45 Path/Mem Lib .. 2-46 BMC Software, Inc., Confidential and Proprietary InformationviCONTROL-M Job Parameter and Variable reference GuidePIPE ..2-50 Scheduling Table Lib ..2-53 Table ..2-54 Task Type ..2-56 Chapter 3 Scheduling ParametersActive From Date ..3-3 Active To Date ..3-8 Adjust Condition ..3-12 And/Or ..3-16 Confcal ..3-18 Dates ..3-24 Days ..3-26 Days Calendar ..3-33 Minimum.

7 3-38 Months ..3-40 PDS ..3-42 Relationship ..3-44 Retro ..3-46 Scheduling Tag ..3-50 Time Zone ..3-54 Week Days ..3-58 Weeks Calendar ..3-65 Chapter 4 Execution ParametersConfirm ..4-3 Critical ..4-5 Cyclic ..4-9 Interval ..4-13 Max Wait ..4-17 Maximum ..4-21 Multi Agent ..4-25 Node ID/Group ..4-28 Prevent NCT2 ..4-31 Priority ..4-36 Request NJE Node ..4-38 Rerun From ..4-41 Rerun Member ..4-43 Scheduling Environment ..4-46 System Affinity ..4-48 BMC Software, Inc., Confidential and Proprietary InformationContentsviiTime From, Time Until .. 4-51 Units .. 4-54 Chapter 5 Condition ParametersIn Condition .. 5-2 Out Condition .. 5-12 Chapter 6 Resource ParametersControl Resources.

8 6-2 Quantitative Resources .. 6-5 Chapter 7 Post-Processing ParametersCTB Step .. 7-4Do AutoEdit .. 7-7Do Cond .. 7-10Do CTBRule .. 7-13Do Forcejob .. 7-17Do If Rerun .. 7-20Do Mail .. 7-25Do NOTOK .. 7-30Do OK .. 7-32Do Rerun .. 7-34Do Shout .. 7-37Do Stop Cyclic .. 7-39Do Sysout .. 7-40On .. 7-44On Statement/Code .. 7-58 Reten Days .. 7-65 Reten Gen .. 7-67 Step Range .. 7-69 Chapter 8 Job Output ParametersAuto-Archive .. 8-2 Shout .. 8-6 Sysout Handling .. 8-16 Chapter 9 Status ParametersStatus parameters Summary .. 9-1 BMC Software, Inc., Confidential and Proprietary InformationviiiCONTROL-M Job Parameter and Variable reference GuideChapter 10 SAP ParametersABAP Program .. 10-5 Account.

9 10-6 Archive ID .. 10-7 Archive Mode .. 10-8 Archiving Object ..10-9 Archive Text .. 10-10 Authorization .. 10-11 Check Sessions .. 10-12 Check Variant .. 10-13 Columns .. 10-14 Copy Spool To .. 10-15 Delete After Print .. 10-16 Department ..10-17 Detect Spawned Jobs .. 10-18 Document Type .. 10-19 External Program .. 10-20 Information Field .. 10-21 Job Class .. 10-22 Job Count .. 10-23 Job Mode .. 10-24 Job Name .. 10-25 Language .. 10-26 Layout .. 10-27 Name ..10-28 New Spool Request .. 10-29 Number of Copies .. 10-30 Object Type .. 10-31 Output Device .. 10-32 Owner .. 10-33 Parameter .. 10-34 Print Expiration .. 10-35 Print Immediately .. 10-36 QID .. 10-37 Recipient.

10 10-38 Rows .. 10-39 SAP Cover Page .. 10-40 SAP Job Status .. 10-41 Selection Cover Page .. 10-42 Steps .. 10-43 BMC Software, Inc., Confidential and Proprietary InformationContentsixStep Type .. 10-44 Submit Job with ASAP Option .. 10-45 Target Host .. 10-46 Target Server .. 10-47 Titles .. 10-48 Variant Name .. 10-49 Wait For Termination .. 10-50 Chapter 11 Oracle Applications ParametersAdvanced Options .. 11-3 Application .. 11-4 Application Instance .. 11-5 Application Name .. 11-6 Application Short Name .. 11-7 Description .. 11-8 Include Child Status .. 11-9 Include Output .. 11-10 Notifications .. 11-11 Parameter Validation .. 11-12 Parent .. 11-13 Phase .. 11-14 Print .. 11-15 Priority.