5.2.4 Jobnet definition
This paragraph explains how to specify a jobnet definition.
To concurrently define multiple unit, specify the upper-level unit definition parameters and then the parameters of a lower-level unit.
The following gives the format of, and parameters for a jobnet definition.
- Format
[sd=[N,]{[[yyyy/]mm/]{[+|*|@]dd |[+|*|@]b[-DD]|[+]{su|mo|tu|we|th|fr|sa} [:{n|b}]}|en|ud};] [st=[N,][+]hh:mm;] [sy=[N,]hh:mm|{M|U|C}mmmm;] [ey=[N,]hh:mm|{M|U|C}mmmm;] [ln=[N,]n;] [cy=[N,] (n,{y|m|w|d});] [sh=[N,]{be|af|ca|no};] [shd=[N,]n;] [wt=[N,]{no|hh:mm|mmmm|un};] [wc=[N,]{no|n|un};] [cftd=[N,]{no|be|af|db|da}[,n[,N]];] [ed=yyyy/mm/dd;] [rg=n;] [pr=n;] [ni=n;] [ha={y|w|a|n};] [ejn=exclusive-jobnet-name;] [cd={no|un|n};] [de={y|n};] [ms={sch|mlt};] [mp={y|n};] [jc=full-path-job-group-name;] [rh="execution-manager-name";] [ex="execution-agent-name";] [fd=time-required-for-execution;] [ar=(f=preceding-unit-name, t=succeeding-unit-name[,relation-type]);] [ncl={y|n};] [ncn=jobnet-connector-name;] [ncs={y|n};] [ncex={y|n};] [nchn="connection-host-name";] [ncsv=connection-service-name;] [mm={and|or};] [nmg={y|n};] [eun=name-of-the-unit-whose-end-is-being-waited-for;] [ega={exec|execdeffer|none};] [uem={y|n};]
- Parameters
-
- sd=[N,]{[[yyyy/]mm/]{[+|*|@]dd|[+|*|@]b[-DD]|[+]{su|mo|tu|we|th|fr|sa} [:{n|b}]}|en|ud};
-
Define the dates when the jobnet is to be executed. You can define up to 144 execution start dates. If you omit this parameter in the root jobnet, the system assumes "1, en".
-
N: When defining multiple jobnet execution start dates, specify a rule number. You can set 0 to 144.
This number corresponds to the rule numbers for the execution start time, start delay time, end delay time and appropriate upper-level jobnet, and the rule numbers for the processing cycle, shift method and maximum shift days.
If you specify sd=0,ud, you can make all the items undefined.
-
yyyy: Specify the calendar year containing the date when the jobnet is executed. You can set a value between 1994 and the value of the SCHEDULELIMIT environment setting parameter. For details about the SCHEDULELIMIT environment setting parameter, see 20.4.2(123) SCHEDULELIMIT in the JP1/Automatic Job Management System 3 Configuration Guide.
The default is the year containing the date when the jobnet was registered for execution.
-
mm: Specify the month when the jobnet is executed. You can set 1 to 12. The default is the month containing the day when the jobnet was registered for execution.
-
+: Sets the date when the jobnet is executed on the basis of a relative day.
-
*: Sets the date when the jobnet is executed on the basis of an open day.
-
@:Sets the date when the jobnet is executed on the basis of a closed day.
-
dd: Define the day when the jobnet is executed.
When specifying an absolute date
Year/month/day: specification 1 to last day of specified year/month.
Month/day specification: 1 to last day of specified month. For February, however, 1 to 29.
Day specification: 1 to 31.
When specifying a relative date or the number of open or closed days
1 to 35 (days).
-
b: Sets the date when the jobnet is executed as the end day of the month.
-
-DD: Specify how many days precede the end of the month or the last open day to set the date when the jobnet is executed. The default is the end of the month or the last open day.
When specifying an absolute date
Year/month/day specification: 0 to (last day of specified year/month -1).
Month/day specification: 0 to (last day of specified month -1). For February, however, 0 to 28.
Day specification: 0 to 30.
When specifying a relative date or the number of open or closed days
0 to 34 (days).
-
su: Sets Sunday as the date when the jobnet is executed.
-
mo: Sets Monday as the date when the jobnet is executed.
-
tu: Sets Tuesday as the date when the jobnet is executed.
-
we: Sets Wednesday as the date when the jobnet is executed.
-
th: Sets Thursday as the date when the jobnet is executed.
-
fr: Sets Friday as the date when the jobnet is executed.
-
sa: Sets Saturday as the date when the jobnet is executed.
-
n: Specify what week from the beginning of the month contains the specified day of the week. You can set 1 to 5 (first week to fifth week). The default is 1 if you have specified a year (yyyy) and month (mm), and the week containing a specified day of the week nearest the date of registration for execution.
-
en: Sets the date when the jobnet is registered for execution as the date when it is executed.
-
ud: Makes all the schedules for the jobnet undefined. Be sure to set N to 0.
-
- st=[N,][+]hh:mm;
-
Define the time when the jobnet is executed. The default is +00:00 (0 hours 00 minutes as the relative time).
-
N: Specify the rule number of the execution start time corresponding to the rule number of the jobnet execution start date. You can set 1 to 144. The default is 1.
-
+: Specify that the hh:mm time when the jobnet is executed is the relative time. The default specifies the absolute time.
-
hh: Specify the hours of the time when the jobnet is executed. You can set 0 to 47. The default is 0.
-
mm: Specify the minutes of the time when the jobnet is executed. You can set 0 to 59 as the minutes value. The default is 0.
-
- sy=[N,]hh:mm|{M|U|C}mmmm;
-
Define the delayed start time for a jobnet.
-
N: Specify the rule number of delayed start time corresponding to the date when the jobnet is executed. You can set 1 to 144. The default is 1.
-
hh: Specify the hours of the delayed start time for a jobnet. You can set 0 to 47.
-
mm: Specify the minutes of the delayed start time for a jobnet. You can set 0 to 59.
-
M: Sets the minutes specified in mmmm as the relative minutes from the time when the root jobnet is executed.
-
U: Sets the minutes specified in mmmm as the relative minutes from the time when the upper-level jobnet is executed.
-
C: Sets minutes the specified in mmmm as the relative minutes from the time when the jobnet is executed.
-
mmmm: Specify the delayed start time as the relative minutes from the time when the root jobnet, upper-level jobnet or the jobnet itself is executed. You can set 1 to 2,879.
-
- ey=[N,]hh:mm|{M|U|C}mmmm;
-
Define the delayed end time for a jobnet.
-
N: Specify the rule number of delayed end time corresponding to the date when the jobnet is executed. You can set 1 to 144. The default is 1.
-
hh: Specify the hours of the delayed end time for a jobnet. You can set 0 to 47.
-
mm: Specify the minutes of the delayed end time for a jobnet. You can set 0 to 59.
-
M: Sets the minutes specified in mmmm as the relative minutes from the time when the root jobnet is executed.
-
U: Sets the minutes specified in mmmm as the relative minutes from the time when the upper-level jobnet is executed.
-
C: Sets minutes the specified in mmmm as the relative minutes from the time when the jobnet is executed.
-
mmmm: Specify the delayed end time as the relative minutes from the time when the root jobnet, upper-level jobnet or the jobnet itself is executed. You can set 1 to 2,879.
-
- ln=[N,]n;
-
Define the rule number of the schedule for the upper-level jobnet. Note that any attempt to specify the root jobnet will be ignored.
-
N: Specify the rule number of the date when the jobnet is executed. You can set 1 to 144. The default is 1.
-
n: Specify the rule number of the date when the upper-level jobnet is executed. You can set 1 to 144.
-
- cy=[N,](n,{y|m|w|d});
-
Define a processing cycle for a jobnet. By default, no processing cycle is set.
-
N: Specify the rule number of the date when the jobnet is executed. You can set 1 to 144. The default is 1.
-
n: Specify the number of processing cycles. The value you can set depends on the parameter (y, m, w, or d) you specify.
-
y: Sets the unit for the processing cycle as a year. For n, you can set 1 to 9 (years).
-
m: Sets the unit for the processing cycle as a month. For n, you can set 1 to 12 (months).
-
w: Sets the unit for the processing cycle as a week. For n, you can set 1 to 5 (weeks). If you have defined the execution start date by an open or closed day (sd=* or sd=@), you cannot specify this parameter. If you specify this parameter, the schedule is calculated assuming that one week is equal to seven open days or seven closed days; however, we recommend that you specify the processing cycle on a daily basis. A good example would be 7,d, instead of 1,w.
-
d: Sets the unit for the processing cycle as a day. For n, you can set 1 to 31 (days).
-
- sh=[N,]{be|af|ca|no};
-
If the jobnet is scheduled to be executed on a closed day on the JP1/AJS3 calendar, define how to substitute the schedule of the closed day job.
-
N: Specify the rule number of the date when the jobnet is executed. You can set 1 to 144. The default is 1.
-
be: Applies the previous day of the execution schedule day if it is closed.
-
af: Applies the next day of the execution schedule day if it is closed.
-
ca: Does not execute the jobnet if the execution schedule day is closed.
-
no: Forcibly executes the jobnet on the closed day set as the execution schedule day only if the JP1/AJS3 service is started.
-
- shd=[N,]n;
-
Define the maximum number of shift days for jobnet execution.
-
N: Specify the rule number of the date when the jobnet is executed. You can set 1 to 144. The default is 1.
-
n: Specify the maximum number of shift days for jobnet execution. You can set 1 to 31 (days). The default is 2.
-
- wt=[N,]{no|hh:mm|mmmm|un};
-
Define the monitoring end time of the start condition. The default is no. Specify this parameter together with the wc parameter.
-
N: Specify the rule number of the date when the jobnet is executed. You can set 1 to 144. The default is 1.
-
no: Does not use a start condition. If this value is specified, the number of executions of the execution generation until the end of monitoring of the start condition in the wc parameter is invalid even if the number of executions is defined.
-
hh: Specify the hour of the monitoring end time of the start condition. You can set 0 to 47.
-
mm: Specify the minute of the monitoring end time of the start condition. You can set 0 to 59.
-
mmmm: Specify the time of the monitoring end time of the start condition by the relative minutes from the time when the start condition monitoring is executed. You can set 1 to 2,879 (minutes).
-
un: Specify no limit for the monitoring end time of the start condition.
-
- wc=[N,]{no|n|un};
-
Define the number of executions of the execution generation from when the monitoring of the start condition starts until the monitoring of the start condition ends. The default is no. Specify this parameter together with the wt parameter.
-
N: Specify the rule number of the date when the jobnet is executed. You can set 1 to 144. The default is 1.
-
no: Does not use a start condition. If this value is specified, the monitoring end time of the start condition in the wt parameter is invalid even if the monitoring end time is defined.
-
n: Specify the number of executions of the execution generation until monitoring of the start condition ends. You can set 1 to 999. The default is 1.
-
un: Specify no limit for the number of executions of the execution generation until monitoring of the start condition ends.
-
- cftd=[N,]{no|be|af|db|da}[,n[,N]];
-
Define the schedule of the jobnet according to the days from the start time. The default is no.
-
N: Specify the rule number of the date when the jobnet is executed. You can set 1 to 144. The default is 1.
-
no: Does not use a schedule according to the days from the start time.
-
be: Replaces the date of jobnet execution by an open day preceding the start date (the execution schedule date fixed by specifying a processing cycle or setting substitution).
-
af: Replaces the date of jobnet execution by an open day following the start date (the execution schedule date fixed by specifying a processing cycle or setting substitution).
-
db: Replaces the date of jobnet execution by the day preceding the start date (the execution schedule date fixed by specifying a processing cycle or setting substitution). Because closed days are not skipped, the jobnet might be executed on a closed day.
-
da: Replaces the date of jobnet execution by the day following the start date (the execution schedule date fixed by specifying a processing cycle or setting substitution). Because closed days are not skipped, the jobnet might be executed on a closed day.
-
n: Specify the number of start days. You can set 1 to 31 (days). The default is 1. If you specify cftd=no, this item is invalid.
-
N: Specify the maximum number of shift days. You can set 1 to 31 (days). The default is 10. If you specify cftd=no, cftd=db, or cftd=da, this item is invalid.
-
- ed=yyyy/mm/dd;
-
Define the expiration date of a defined schedule. By default, the system does not check the expiration date.
-
yyyy: Specify the calendar year of the expiration date. You can set a value between 1994 and the value of the SCHEDULELIMIT environment setting parameter. For details about the SCHEDULELIMIT environment setting parameter, see 20.4.2(123) SCHEDULELIMIT in the JP1/Automatic Job Management System 3 Configuration Guide.
-
mm: Specify the month of the expiration date. You can set 1 to 12.
-
dd: Specify the day of the expiration date. You can set 1 to 31.
-
- rg=n;
-
Define saved generations of the jobnet. You can, however, enable the system setting option to increase the number of generations to up to 999. The default is 1. You can specify this parameter only for the root jobnet. For a nested jobnet, the system inherits a value defined for the root jobnet.
- pr=n;
-
Define the default for the priority of jobnet job execution. You can set 1 to 5. The lowest priority of execution is 1, while the highest priority is 5. The default value depends on the definition of upper-level jobnets.
The value specified in this parameter is used if the pr parameter is not specified for the jobs in the jobnet. The system assumes a value of 1 as the priority in job execution if this parameter is not specified for any of the upper-level jobnets (including the highest level) and if the ni parameter is not specified.
If this and the ni parameter are specified together, the value of the second parameter will be valid.
- ni=n;
-
Define the default for the priority of jobnet job execution. You can set -39 to 39. The specified value is replaced by the default for the priority of job execution in the pr parameter. The relationship is summarized below.
ni parameter settings
Default for the priority of job execution
11 to 39
5
1 to 10
4
0
3
-10 to -1
2
-39 to -11
1
The default value depends on the definition of upper-level jobnets.
The value specified in this parameter is used if the pr parameter is not specified for the jobs in the jobnet. The system assumes a value of 1 as the priority of job execution if this parameter is not specified for any of the upper-level jobnets (including the highest level) and if the pr parameter is not specified.
If this parameter is specified together with the pr parameter, the value of the parameter specified later will be effective.
- ha={y|w|a|n};
-
Define whether to suspend jobnet execution. The default is n. If you specify w or a for a nested jobnet, the system assumes n.
-
y: Suspends jobnet execution.
-
w: Suspends jobnet execution only if the last jobnet end status is Ended with warning, Ended abnormally, Skipped so not exe., Invalid exe. seq., Interrupted, or Killed. You cannot specify this parameter with mp=y.
-
a: Suspends jobnet execution only if the last jobnet end status is Ended abnormally, Skipped so not exe., Invalid exe. seq., Interrupted, or Killed.
-
n: Does not suspend jobnet execution.
-
- ejn=exclusive-jobnet-name;
-
Define the name of a jobnet you do not want to execute while executing this jobnet (a jobnet in the same level).
You can set a character string of 1 to 30 bytes. Note that if the character encoding is UTF-8 and sjis is specified for the DEFLENTYPE environment setting parameter, you can specify from 1 to 30 bytes after conversion to Shift-JIS.
- cd={no|un|n};
-
Define the number of days after which the waiting is canceled for the jobnet in the Being held, Wait for start cond or Waiting for the start time status.
The default is no.
-
no: The value set in the system option is applied as the timeout of the wait status.
-
un: Waits without setting a timeout.
-
n: Specify the number of days the jobnet waits. Specify the relative number of days from the base date for the job group to which the jobnet belongs. You can set 1 to 2 (days).
-
- de={y|n};
-
Define dependence on the schedule for the upper-level jobnet. The default is y. You cannot define this parameter for the root jobnet.
-
y: The jobnet depends on the schedule for the upper-level jobnet. You cannot specify this parameter together with the sd parameter.
-
n: The jobnet does not depend on the schedule for the upper-level jobnet.
-
- ms={sch|mlt};
-
Define a schedule option for jobnet execution. The default is sch.
-
sch: Uses a schedule skip option.
-
mlt: Uses a multi-schedule option.
-
- mp={y|n};
-
Define whether to enable concurrent jobnet execution. The default is n.
-
y: Enables concurrent execution. You cannot specify this together with ha=w or ha=a.
-
n: Disables concurrent execution.
-
- jc=job-group-full-name;
-
Define the job group name that contains the definition of the calendar information specified on a jobnet basis.
You can set a character string of 1 to 930 bytes.
- rh="execution-manager-name";
-
Define the name of the JP1/AJS3 - Manager host in which a remote jobnet will be executed.
You can set a character string of 1 to 255 bytes. If you omit this option, a message KAVS0289-E is output as the execution result of the remote jobnet, and an error occurs.
If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.
- ex="execution-agent-name";
-
Define the name of the execution agent or execution agent group that is used to execute jobs.
You can set a character string of 1 to 255 bytes.
If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character with #. That is, use #" instead of ", and use ## instead of #.
You can specify a macro variable.
If job definition information contains no specified agent name to execute, the system uses the name set here. If this parameter is not specified, the following value is assumed:
-
The local host name is assumed for the root jobnet.
-
The value of the upper-level jobnet is assumed for a nested jobnet.
-
The value specified for the execution manager is assumed for a remote jobnet.
-
- fd=time-required-for-execution;
-
Define the time required for executing the jobnet or remote jobnet for which the termination delay is monitored.
You can specify a decimal value between 1 and 2,879 (minutes).
- ar=(f=preceding-unit-name, t=succeeding-unit-name[,relation-type]);
-
Define the order in which units are executed. (This definition is equivalent to defining execution order by relating icons in the map area in the Jobnet Edit window for JP1/AJS3 - View.)
-
f=preceding-unit-name: Specify the name of a unit or judgment job to be executed earlier. You can set a character string of 1 to 30 bytes.
-
t=succeeding-unit-name: Specify the name of a unit to be executed subsequently or dependent unit. You can set a character string of 1 to 30 bytes.
-
relation-type: Define the method of establishing a relationship. The default is seq.
seq: Sequential relationship
con: Provides a conditional connection with the judgment job as a dependent unit. This can be specified only when the preceding unit name contains a judgment job.
-
- ncl={y|n};
-
For a root jobnet, define whether to use a jobnet connector to control the execution order. If you omit this option, the system assumes n.
You can specify this option only for a root jobnet.
-
y: The execution order of the root jobnet is controlled.
-
n: The execution order of the root jobnet is not controlled.
-
- ncn=jobnet-connector-name;
-
If the execution order of a root jobnet is to be controlled, specify the unit full name of the jobnet connector to be connected. You can specify a character string of 1 to 930 bytes. If you specify any of the following unit names, an error occurs:
-
A unit name that does not begin with a slant (/)
-
A unit name in which a character string between slants (/) exceeds 30 bytes
-
A unit name that ends with a slant (/)
You can specify this option only for a root jobnet. If you specify this option when y has not been specified for the ncl parameter, an error occurs.
-
- ncs={y|n};
-
If the execution order of a root jobnet is to be controlled, define the execution order control method. If you omit this option, the system assumes n. You can specify this option only for a root jobnet. If you specify this option when y has not been specified for the ncl parameter, an error occurs.
-
y: The root jobnet is executed synchronously with the jobnet connector.
-
n: The root jobnet is executed asynchronously with the jobnet connector.
-
- ncex={y|n};
-
If the execution order of a root jobnet is to be controlled, define whether to enable linkage between scheduler services. If you omit this option, the system assumes n.
You can specify this option only for a root jobnet.
If you specify this option when y has not been specified for the ncl parameter, an error occurs.
-
y: Linkage between scheduler services is enabled.
Linkage with jobnet connectors defined on other hosts or in other scheduler services is possible.
-
n: Linkage between scheduler services is disabled.
Linkage with jobnet connectors defined in only the same scheduler service is possible.
-
- nchn="connection-host-name";
-
Specify the name of the host on which the jobnet connector to be connected has been defined. You can specify a character string of 1 to 255 bytes. You cannot specify spaces, tab characters, or linefeed characters.
You can specify this option only for a root jobnet. If you specify this option when y has not been specified for the ncex parameter, an error occurs.
If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.
- ncsv=connection-service-name;
-
Specify the name of the scheduler service in which the jobnet connector to be connected has been defined. You can specify a character string of 1 to 30 bytes.
You can specify this option only for a root jobnet. If you specify this option when y has not been specified for the ncex parameter, an error occurs.
- mm={and|or};
-
Define the wait method with respect to the specified units whose ends are being waited for.
The default is and.
-
and: Start executing at completion of all units whose ends are being waited for.
-
or: Start executing at completion of one of the units whose ends are being waited for.
-
- nmg={y|n};
-
Define the behavior when there are no generations of the root jobnet for the specified unit whose end is being waited for.
The default is n.
-
y: Start executing.
-
n: Do not start executing.
-
- eun=name-of-the-unit-whose-end-is-being-waited-for;
-
Define the full-path name of a unit whose end is being waited for.
To specify multiple units, repeat the parameter. You can specify a maximum of 32 units.
You can use a character string of 1 to 930 bytes as the unit name.
- ega={exec|execdeffer|none};
-
Specify the behavior when a jobnet with start conditions is specified as the jobnet whose end is being waited for and the execution generation ends abnormally.
If you omit this option, the system assumes none.
-
exec: Start executing.
-
execdeffer: Do not start executing. However, if the execution generation is in the Skipped so not exe. status, start executing.
-
none: Do not start executing.
-
- uem={y|n};
-
Specify the behavior when a jobnet with start conditions is specified as the jobnet whose end is being waited for and the monitoring generation is in the Unmonitored + Ended status.
If you omit this option, the system assumes n.
-
y: Start executing.
-
n: Do not start executing.
-