ajsschedule
- Organization of this page
Format
ajsschedule
[-F service-name]
-b[[year/]month/]day
-e[[year/]month/]day
root-jobnet-name
Description
Creates a jobnet execution schedule for a certain period. The result of the creation is output to the standard output file according to the format of the schedule information parameter. For details about the schedule information parameter, see 5.4 Creating a schedule information file.
Execution privileges
You must have any of the following JP1 privileges:
-
JP1_AJS_Admin privilege
-
JP1_AJS_Manager privilege
-
JP1_AJS_Editor privilege
-
JP1_AJS_Operator privilege
-
JP1_AJS_Guest privilege
Arguments
-F service-name
Specify the name of the target scheduler service.
You can specify a character string of 1 to 30 bytes.
-b [[year/]month/]day
Specify the start date of the period applied to a schedule to be created.
The start time is the base time.
-
year
You can specify a value between 1994 and 2036 for the year.
-
month
You can specify a value between 1 (or 01) and 12.
-
day
You can specify a value between 1 (or 01) and 31.
If you omit the year or the year/month in this option, the following values are assumed.
year: Year when the command was executed
year/month: Year and month when the command was executed
-e [[year/]month/]day
Specify the end date of the period applied to a schedule to be created. The end date must be the same as or follow the start date.
The end time is the base time plus 23 hours: 59 minutes: 59 seconds.
-
year
You can specify a value between 1994 and 2036 for the year.
-
month
You can specify a value between 1 (or 01) and 12.
-
day
You can specify a value between 1 (or 01) and 31.
If you omit the year or the year/month in this option, the following values are assumed.
year: Year when the command was executed
year/month: The year and month in which you executed the command
root-jobnet-name
Specify the name of a target root jobnet by using a maximum of 930 bytes.
Note that you cannot use wildcard characters to create an execution schedule for multiple root jobnets. If you specify a character string that includes a wildcard character and the specification can represent multiple root jobnets, an execution schedule is created for only one root jobnet.
Also note that you cannot specify a logical host name or execution ID for root-jobnet-name.
Notes
-
Either of the following users can create an execution schedule:
-
A user granted the reference privilege when the jobnet was defined or when its attributes were changed
-
A JP1 user mapped to the OS user who has Administrators or superuser privileges
Note, however, that if yes is set after changing the ADMACLIMIT environment setting parameter from its default, even a JP1 user who was mapped to an OS user with Administrators or superuser privileges must have the reference privilege.
-
-
The execution date can be specified in the -b or -e option. For the execution date, see 3.3.1 Time formats and schedule rules for root jobnets in the manual JP1/Automatic Job Management System 3 Overview.
-
If the 48-hour schedule is used for the schedule definition of a root jobnet, be careful with the base time. If the base time is not 0:00, for a root jobnet that will be executed across two days, the schedule information output by this command might be different from the schedule that is actually defined. For details about the execution date output by the command, see 3.3.1 Time formats and schedule rules for root jobnets in the manual JP1/Automatic Job Management System 3 Overview. For the execution time of a nested jobnet, a time in the range from 0:00 to 23:59 is output, even if the jobnet is executed across two days. The concept of the base time is not necessary for a nested job because a nested job follows the root jobnet, which uses the base time for execution. For this reason, the 24-hour schedule is used for the execution time output for a nested job.
-
If the specified root jobnet is a release target root jobnet (a root jobnet for which release entry has been made), the definition of the schedule to be created changes on the release date. On and after the release date, the new jobnet definition (the definition of the release-source jobnet) is applied.
Return values
|
0 |
Normal end |
|
Multiple of 4 within the range from 4 to 124 |
Abnormal end |
Example
The following command creates the schedule of jobnet net1 for June 20XX.
ajsschedule -b 20XX/6/1 -e 20XX/6/30 /net1
Output example
PN=net1:20XX06050000:h::::::;
{
PJ=job:y:y:h;
}
PN=net1:20XX06120000:h::::::;
{
PJ=job:y:y:h;
}
PN=net1:20XX06190000:h::::::;
{
PJ=job:y:y:n;
}
PN=net1:20XX06260000:h::::::;
{
PJ=job:y:y:n;
}