This is a control statement for setting job net startup days.
Synopsis
SCH ---------- (1) jobnetname Job net name ---------- (2) (*) (Note 1) execpattern Schedule pattern name ---------- (3) (**) execpatmode Method to combine the schedule patterns ---------- (4) (Note 2) basenet Base job net name ---------- (5) (**) execday Startup day setting ---------- (6) cancelday Startup day setting cancellation ---------- (7) jobschprintr Startup day bit pattern ---------- (8) annuallydate Date setting for every year ---------- (9) (**) annuallyweek Day of the week setting for every year ---------- (10) (**) monthlydate Date setting for every month ---------- (11) (**) monthlyweek Day of the week setting for every month ---------- (12) (**) bnsmode Criteria of business day basis ---------- (13) (**) (Note 5) bnsbase Month's start date of business day basis ---------- (14)(**) (Note 6) bnsday Business days ---------- (15)(**) bnslimit Set only business days of the month as startup days ---------- (16)(**) offsetmode Offset ---------- (17) offsetday Number of offset days ---------- (18) offsetholiday Sets the base day as a working day if it falls on a holiday -- (19) holidayshift Holiday shift ---------- (20) (*) shiftlimit Number of maximum shifts ---------- (21) (Note 4) holidaycalendar Calendar name ---------- (22) holidaymode Condition for combining calendars ---------- (23) (Note 3) enablestart Start date of validity period ---------- (24) enableend End date of validity period ---------- (24) disablestart Start date of invalidity period ---------- (25) disableend End date of invalidity period ---------- (25) ;
The jobnetname operand should be specified immediately after the SCH keyword.
The execpatmode operand should be specified immediately after the execpattern operand.
The holidaymode operand should be specified immediately after the holidaycalendar operand.
The shiftlimit operand should be specified immediately after the holidayshift operand.
The bnsmode operand cannot be specified with the offsetmode operand, the offsetday operand, or offsetholiday operand simultaneously.
This operand must be specified when the bnsmode operand is specified.
This must be specified.
Specify one of the following. This can be omitted
execpattern
basenet
annuallydate and/or annuallyweek
monthlydate and/or monthlyweek
bnsmode, bnsbase, bnsday, bnslimit (The bnsmode operand and the bnsbase operand must be specified if these operands group is specified.)
About This Control Statement
(1) SCH
This is the keyword that indicates the beginning of a startup days control statement
(2) jobnetname Job net name
Specify the name of a job net for which startup days are to be set.
When you specify a message event control statement and a temporary changes control statement along with this statement, specify the same job net name across those statements.
(3) execpattern Schedule pattern name
When you apply a schedule pattern, specify the schedule pattern name that is already registered.
(4) execpatmode Method to combine the schedule patterns
Choose one of the following parameters to specify a method of combining schedule patterns when more than one schedule pattern is specified. If omitted, the default is "AND".
Sets the days as startup days if they are set as startup days in all the schedule patterns.
Sets the days as startup days if they are set as startup days in at least one of the schedule patterns.
(5) basenet Base job net name
When you use a base job net, specify the name of job net that is already registered as the base job net. This operand cannot be specified if the job net itself declares as the base job net in this statement.
(6) execday Startup day setting
Specify the scheduled startup days for the job net. When setting the startup day of MM (month) DD (day) in YYYY (year), the format should be "MM,DD,YYYY". More than one startup day can be set. If you set with the schedule pattern name in combination, you can set the startup days more easily.
Example of startup day setting
To set October 1 and 10 in 2010 as startup days:
execday 10,01,10,2010
To set October 1 and December 10 in 2010 as startup days:
execday 10,01,2010 execday 12,10,2010
(7) cancelday Startup day setting cancellation
Specify the date for which you want to cancel the execution setting. Specify this operand in the same format as the one in the "Startup day setting" operand.
(8) jobschprintr Startup day bit pattern
Specify the bit pattern data for the Startup day setting expanded by using the jobschprint -r command. (If any value other than those expanded by the jobschprint command is specified, operation cannot be guaranteed. Also, operation is not guaranteed for any value other than those resulting from execution of different version of the jobschprint command. A different year from the one obtained by the jobschprint command cannot be specified in this operand.) If the bit pattern data is specified, you can make settings for three years in the same startup days as the job net expanded using the jobschprint -r command. Immediately after setting this operand, recalculation for startup days by using other startup days setting operands (such as monthly calendar, annual calendar, base job net name, schedule pattern, calendar name, holiday shift, offset, enable/disable period, etc.) cannot be performed. Even if the startup days are changed by this operand, the changes are not applied to the startup days of other job nets that use this job net as the base job net.
(9) annuallydate Date setting for every year
When you use an annual calendar, specify dates when the job net is executed for every year. When you set MM (month) DD (day) as a startup day, specify in the "MMDD" format. More than one startup day can be set.
(10) annuallyweek Day of the week setting for every year
When you use an annual calendar, specify the day(s) of the week on a monthly basis in which the job net is executed. It is only one month that can be specified with one operand. To set more than one month, specify this operand repeatedly. To specify this operant, enter a month as a number between 1 and 12 that is followed by the first three letters of the day of the week. The format should look similar to the following:12,SUN,MON,TUE,WED,THU,FRI,SAT.
(11) monthlydate Date setting for every month
When you use a monthly calendar, specify the date(s) in which the job net is executed for every month. To set DD (day) of every month as the startup day, specify "DD". More than one startup day can be set. To execute the job net at the end of every month, enter "LAST".
(12) monthlyweek Day of the week setting for every month
When you use a monthly calendar, specify the day(s) of the week on a weekly basis in which the job net is executed for every month. It is only one week that can be specified with one operand. To set more than one week, use this operand repeatedly. To specify this operand, enter the ordinal number of the week (where 1 - 5 represents the first through the fifth week, 0 indicates that every week is specified, and 6 represents the last week of the month) with a number between 0 and 6 that is followed by the first three letters of the day of the week. The format should look similar to the following: 5,SUN,MON,TUE,WED,THU,FRI,SAT.
(13) bnsmode Criteria of business day basis
When "Business days" is selected in the Basic information, specify either "Month's start date" or "Month's end date" as the selection criteria of business days.
Counts the business days from the Month's start date.
Counts the business days back from the Month's end date.
(14) bnsbase Month's start date of business day basis
When "Business days" is selected in the Basic information, enter a value of the "Month's start date". "0" is invalid.
Indicates 1st to 28th of month.
Indicates the end of month.
(15) bnsday Business days
When "Business days" is selected in the Basic information, specify business days. To specify more than one business days, use a comma (,) as a separator. "0" is invalid.
The business days that are specified by counting from the 1st business day (the first business day of the month) using a range from 1 to 31. This parameter cannot be specified if "END" is set to the bnsmode operand.
The business days that are specified by calculating back from the -1st business day (the last business day of the month) using a range from -1 to -31. This parameter cannot be specified if "START" is set to the bnsmode operand.
(16) bnslimit Set only business days of the month as startup days
When "Business days" is specified in the Basic information, specify whether "Set only business days of the month as startup days" is set to ON or OFF. If the bnsmode operand is specified, the default is "ON".
"Set only business days of the month as startup days" is selected.
"Set only business days of the month as startup days" is not selected.
(17) offsetmode Offset
Specify the method for counting the number of days shifted from the standard date by selecting any of the following parameters. If omitted, the default is "EXECDAY".
Counts the number of days to be shifted based on working days on the calendar.
Counts the number of days to be shifted based on the absolute number of days, regardless of holidays.
(18) offsetday Number of offset days
Specify the number of days to be shifted from the standard date between -99 and 99. If omitted, the default is "0".
(19) offsetholiday Sets the base day as a working day if it falls on a holiday
Specify what happens if the base day is a holiday when counting the number of days shifted from the base day. If omitted, the default is "OFF".
This operand cannot be specified if "DAY" has been specified for offset.
Sets the base day as a working day even if it falls on a holiday, and it is set as the base day for the number of days shifted.
Sets the base day as a non-working day if it falls on a holiday, and it is not set as the base day for the number of days shifted.
(20) holidayshift Holiday shift
If the startup days that are registered or set in the schedule pattern fall on holidays, select a method to handle them by selecting one of the following parameters:
Shifts the job net startup day to the preceding day.
Shifts the job net startup day to the next day.
Recognizes the day as a holiday, so does not execute the job net.
Recognizes the day as a startup day, so starts the job net.
(21) shiftlimit Number of maximum shifts
Set the number of days by specifying a number between "0" and "99", on which execution is suspended because the Holiday shift is performed on the consecutive holidays. If omitted, the default is "0".
(22) holidaycalendar Calendar name
Specify the name of the calendar (for the SYSTEM_CALENDAR or some other) to be used as the base when startup days are generated. You can specify up to five calendar names per one job net. To specify more than one calendar, use a comma (,) as a separator.
(23) holidaymode Condition for combining calendars
When you specify a method of combining multiple calendars, select either of the following parameters. If omitted, the default is "AND".
Sets the days as holidays if they are set as holidays in all calendars.
Sets the days as holidays if they are set as holidays in at least one of the calendars.
(24) enablestart Start date of validity period/enableend End date of validity period
Specify the operating period of the job net in the "MM,DD,YYYY" format. If the start date of validity period is omitted, the job net operation is enabled from the current date until the end date of validity period. If the end date of validity period is omitted, the job net operation is enabled from the start date of validity period onward. If both the start date and end date of validity period are omitted, the job net operation is enabled on every day.
(25) disablestart Start date of invalidity period/disableend End date of invalidity period
Specify the non-operating period for the job net in the "MM,DD,YYYY" format. If the start date of invalidity period is omitted, the job net operation is disabled from the current day until the end date of invalidity period. If the end date of invalidity period is omitted, the job net operation is disabled from the start date onward. If both the start date and end date of invalidity period are omitted, the job net operation is enabled on every day.
