5.1.1 Details of definition items
The definition information management template defines 15 items. These definition items are described in tables shown below for each section in the template.
Each table has the following columns:
- Item name
-
This column indicates the name of the definition item.
- Description
-
This column describes what the item defines and how to specify the item. For an item to be specified with one of the predefined constants, this column shows them. For an item to be specified with an arbitrary string, this column shows the conventions to specify the string. This column also shows the default, if any.
Note that, unless the item is a multi-value item, line breaks included in the value are deleted and the value is handled as one-line data.
You can use environment setting parameters to add user-specific entry conventions. For details about environment setting parameters, see 3.1.4 Environment settings and 3.2 Environment settings parameters.
- Display
-
With the initial settings, the definition information management template displays only the items that may frequently be used. This column indicates whether the item is displayed in the template with the initial settings. When the item is displayed, Y is indicated; when not displayed, N is indicated.
You can use environment setting parameters to change the items to be displayed with the initial settings. For details about environment setting parameters, see 3.1.4 Environment settings and 3.2 Environment settings parameters.
- Organization of this subsection
-
(1) Processing-type specification section for EXPORT
Item name |
Description |
Display |
---|---|---|
Section |
Select one of the following processing types when executing EXPORT:
|
Y |
(2) Unit definition information section
Item name |
Description |
Display |
---|---|---|
Unit name |
Specify a unit name. If you leave this item blank, the unit information becomes invalid. You cannot specify the root job group (/) as a unit name. Possible length of the value: 1 to 30 bytes |
Y |
Complete name of upper unit |
Specify the complete name of the upper unit of the unit specified in Unit name. This item must begin with a slash (/). When you specify the root job group, do not specify this item. Possible length of the value: 1 to 930 bytes |
Y |
Unit type |
Specify one of the following unit types: g: Defines a job group. mg: Defines a manager job group. n: Defines a jobnet. rm: Defines a remote jobnet. rc: Defines start conditions for a root jobnet. mn: Defines a manager jobnet. j: Defines a UNIX job. pj: Defines a PC job. qj: Defines a QUEUE job. jdj: Defines a judgment job. orj: Defines an OR job. evwj: Defines a JP1 event reception monitoring job. flwj: Defines a file monitoring job. mlwj: Defines an email reception monitoring job. mqwj: Defines a message queue reception monitoring job. mswj: Defines an MSMQ reception monitoring job. lfwj: Defines a log file monitoring job. ntwj: Defines a Windows event-log monitoring job. tmwj: Defines an execution interval control job. evsj: Defines a JP1 event sending job. mlsj: Defines an email sending job. mqsj: Defines a message queue sending job. mssj: Defines an MSMQ sending job. cmsj: Defines an HP OpenView status report job. pwlj: Defines a local power control job. pwrj: Defines a remote power control job. cj: Defines a custom UNIX job. cpj: Defines a custom PC job. nc: Defines a Jobnet connector. |
Y |
Custom type |
Specify the class names of custom jobs for each program to be linked with. You must specify this item when using custom jobs. The custom job that can be defined directly using JP1/AJS3 - Definition Assistant and the class name to be specified are as follows:
Note that if imported definition information includes other custom jobs, they are displayed as shown below.
|
Y |
Position |
Specify the display position of a jobnet or job in JP1/AJS3 - View or JP1/AJS2 - View. The display position is specified with the vertical and horizontal coordinates represented by the row and column counts. If you do not specify this item, jobnet and job icons are placed at random in JP1/AJS3 - View or JP1/AJS2 - View.
|
Y |
Size |
Specify the maximum number of icons displayed in the JP1/AJS3 - View window or the JP1/AJS2 - View window.
|
Y |
(3) Unit common definition information section
Item name |
Description |
Display |
---|---|---|
Comment |
Write a comment. Displayable length of the value: 1 to 80 bytes |
Y |
Previous |
Specify the unit followed by the one specified in Unit name. The previous unit must exist within the same upper unit. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter). Number of characters that can be specified on one line: 1 to 30 bytes To release the existing connection, input :X after the unit name (like sample:X). |
Y |
Relation type |
Specify how to connect the unit with the one specified in Previous.
Default: seq |
Y |
Exec-agent |
Length of the value: 1 to 255 bytes |
Y |
Exec. order control |
Specify whether to connect to the jobnet connector. You can specify planning groups or root jobnets.
Default: No |
Y |
Jobnet connector# |
Specify the complete unit name of the jobnet connector that is being connected to. Length of the value: 1 to 930 bytes You can specify planning groups or root jobnets. An error occurs if Yes is not specified for Exec. order control. |
Y |
Exec. order method |
Define the execution order control method of the jobnet connector. You can specify planning groups or root jobnets.
Default: Asynchro |
Y |
Connection range |
Define whether linkage occurs between scheduler services with execution order control. The default is Same service. You can specify root jobnets, planning groups, or jobnet connectors. In a root jobnet or a planning group, an error occurs if Yes is not set for Exec. order control.
Default: Same service |
Y |
Connection host |
Specify a host name with a root jobnet, planning group, or jobnet connector defined as the connection target. You can specify root jobnets, planning groups, or jobnet connectors. Length of the value: 1 to 255 bytes Default: No characters are assumed. |
Y |
Connection service |
Specify a scheduler service name with a root jobnet, planning group, or jobnet connector defined as the connection target. You can specify root jobnets, planning groups, or jobnet connectors. In a root jobnet or a planning group, an error occurs if Other service is not set for Connection range. Length of the value: 1 to 30 bytes |
Y |
- #
-
The definition information is updated without error even if you specify a non-existent unit or a unit other than the jobnet connector as the jobnet connector name, and use a batch definition, an individual definition, or the modification function to perform export.
(4) Unit common attributes information section
Item name |
Description |
Display |
---|---|---|
Hold |
Define whether to suspend jobnet or job execution.
You can specify w or a for the root jobnet only. If you specify w or a for a nested jobnet, n is assumed. Default: n |
Y |
Type |
Use either of the following keywords to specify whether to make the unit a recovery job: Normal: Does not make the unit a recovery job. Recovery: Makes the unit a recovery job. You cannot specify Recovery when Unit type is g, mg, rc, mn, or nc. Default: Normal |
Y |
Owner |
Specify the name of the JP1 user who owns the unit. Length of the value: 1 to 31 bytes Default: The JP1 user name of the user who created the unit |
Y |
JP1 resource group |
Specify a JP1 resource group name. Specifiable characters: Alphanumeric characters and an underscore (_) Length of the value: 1 to 63 bytes Default: Blank |
Y |
(5) Manager unit definition information section
Item name |
Description |
Display |
---|---|---|
Host to reference |
Specify the name of JP1/AJS3 - Manager host or JP1/AJS2 - Manager host. Default: The manager host name specified in the MANAGER-HOST environment setting parameter Length of the value: 1 to 255 bytes |
N |
Unit to reference |
Specify the complete name of a unit on the manager host. Length of the value: 1 to 961 bytes |
N |
(6) Job group definition information section
Item name |
Description |
Display |
---|---|---|
Base day |
Specify the base date as calendar information.
|
Y |
Treat as |
Specify the base month as calendar information.
|
Y |
Base time |
Specify the base time in the hh:mm format as calendar information.
|
Y |
Job group type |
Use one of the following keywords to specify the type of the job group: p: Planning group n: Job group Default: n |
Y |
(7) Calendar definition information section
Item name |
Description |
Display |
---|---|---|
Standard week |
Specify an open day or closed day as a day of the week for calendar information.
If no upper job groups have this item specified, all the days of the week will be set to open days. Note that if this setting conflicts with the Open day and Closed day settings, the Open day and Closed day settings prevail. |
Y |
Open day |
Specify an open day on a per-day basis for calendar information, in the YYYY/MM/DD format. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter).
If no upper job groups have this item specified, all days will be set to open days. To release an existing open day, input :X after the open day (in the YYYY/MM/DD:X format). |
Y |
Closed day |
Specify a closed day on a per-day basis for calendar information, in the YYYY/MM/DD format. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter).
If no upper job groups have this item specified, all days will be set to open days. To release an existing closed day, input :X after the closed day (in the YYYY/MM/DD:X format). |
Y |
(8) Jobnet definition information section
Item name |
Description |
Display |
---|---|---|
Concurrent exec. |
Specify whether to enable concurrent jobnet execution.
Default: n |
Y |
No. logs to keep |
Specify the number of jobnet generations to be kept. You can specify this parameter only for the root jobnet. All the nested jobnets inherit the value specified for the root jobnet. Specifiable value: 1 to 99 (generations) Default: 1 |
Y |
Target manager |
Specify the name of the JP1/AJS3 - Manager host or the JP1/AJS2 - Manager host in which a remote jobnet will be executed. Default: The manager host name specified in the MANAGER-HOST environment setting parameter. Length of the value: 1 to 255 bytes |
Y |
Priority |
Specify the default for the priority of jobnet job execution. Specifiable value: 1 to 5 The lowest priority of execution is 1, while the highest priority is 5. Default: Depends on the definition of upper-level jobnets. |
Y |
Time-out period |
Define the number of days until standby status is terminated for jobnets in any of the following statuses: "holding", "condition-wait", and "time-wait" when the scheduled execution startup time has been passed because the execution of the jobnet has been prevented. You can specify one of the following values:
Default: no |
Y |
Schedule option |
Specify a schedule option for jobnet execution.
Default: sch |
Y |
Required exec. time |
Specify the time required for executing the jobnet or remote jobnet for which the termination delay is monitored. Specifiable value: 1 to 2879 (minutes) |
Y |
(9) Jobnet connector definition information section
Item name |
Description |
Display |
---|---|---|
Connect destination# |
Specify the complete unit name of the root jobnet or the planning group of the connection destination. Length of the value: 1 to 930 bytes |
Y |
- #
-
The definition information is updated without error even if you specify a non-existent unit or a unit other than the planning group and root jobnet as the connection destination jobnet name, and use a batch definition, an individual definition, or the modification function to perform export.
(10) Start-condition definition information section
Item name |
Description |
Display |
---|---|---|
Start Condition |
Use either of the following keywords to specify how to handle the start conditions:
Default: and |
Y |
(11) Schedule definition information section
Item name |
Description |
Display |
|
---|---|---|---|
Depends on upper-level jobnet |
Specify dependence on the schedule for the upper-level jobnet. You cannot specify this item for the root jobnet. Use either of the following keywords to specify this item:
Default: y |
Y |
|
Valid term |
Specify the effective dates of the defined schedule in yyyy/mm/dd format.
|
Y |
|
Job group name |
Specify the name of another job group that contains the definition of the calendar information you want to reference. Length of the value: 1 to 930 bytes |
Y |
|
Exclusive jobnet |
Specify the name of a jobnet you do not want to execute while executing this jobnet (a jobnet in the same level). Length of the value: 1 to 30 bytes |
Y |
|
Rule number to link |
Define the rule number of the start day of the corresponding upper level jobnet. Specifiable value : 1-144 By default, the rule number and the link number become same. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). |
Y |
|
Start day |
Type |
Specify the type of the jobnet execution start day. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter). Use one of the following keywords to specify this item:
|
Y |
Year/Month |
Specify the start year and month for jobnet execution in the yyyy/mm format. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter).
|
Y |
|
Day |
Specify the day for jobnet execution. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter).
|
Y |
|
Start time |
Specify the time when the jobnet is executed in the [+]hh:mm format. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter).
Default: +00:00 (0 hours 00 minutes as the relative time) |
Y |
|
Processing cycle |
Specify a processing cycle for a jobnet. By default, no processing cycle is set. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter). Use one of the following keywords to specify this item:
Default: Unspecified |
Y |
|
Substitute schedule of closed day job |
If the jobnet is scheduled to be executed on a closed day on the JP1/AJS calendar, specify how to substitute the schedule of the closed day job. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter). Use one of the following keywords to specify this item:
Default: Cancel |
Y |
|
Shift days |
Specify the maximum number of shift days for jobnet execution. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter). Specifiable value: 1 to 31 Default: 2 |
Y |
|
Schedule by days from start |
Specify the schedule of the jobnet according to the days from the start time. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter).
If this setting is omitted, the shifted schedule will not be used. |
Y |
|
Max. shiftable days |
Specify the maximum number of shift days. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter). Specifiable value: 1 to 31 Default: 10 |
Y |
|
Monitor delay |
Specify the delay time for the start or stop of the jobnet, in one of the following formats: hh:mm Mmmmm Ummmm Cmmmm This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter).
|
Y |
|
Start condition |
Times |
Specify the number of times the jobnet waits for an event that causes the jobnet to execute after the jobnet is executed by the event for the first time. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter).
Default: no |
Y |
Period |
Specify the time when the status of the jobnet waiting for an event is released. Use one of the following values to specify this item: no hh:mm mmmm un This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter).
Default: no |
Y |
(12) Basic job definition information section
Item name |
Description |
Display |
|
---|---|---|---|
Command statement |
Specify the command text of the UNIX job. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter). Number of characters that can be specified in a cell: 1 to 1,023 bytes
|
Y |
|
Execution file name |
For a UNIX job, specify a script file name on the agent host where the job is executed. For a PC job or QUEUE job, specify an executable file name on the agent host. Length of the value: 1 to 511 bytes |
Y |
|
Parameters |
Define parameters for the target file. Length of the value: 1 to 1,023 bytes |
Y |
|
Environment variables |
Specify an environment variable in the variable-name=value format. This is a multi-value item. To specify multiple values, specify them in the same cell, separating each value with a line break (Alt+Enter). Length of the value: 1 to 20,479 bytes |
Y |
|
Environment file |
Specify the environmental variable file name existing on the agent host. Length of the value: 1 to 511 bytes |
Y |
|
Working path |
Specify the working path in the full path name. Length of the value: 1 to 511 bytes |
Y |
|
Standard input |
Specify the name of the standard input file existing on the agent host where the job is executed. Length of the value: 1 to 511 bytes |
Y |
|
Standard output |
File name |
Specify the name of the standard output file existing on the agent host where the job is executed. Length of the value: 1 to 511 bytes |
Y |
Append |
Specify the append option for the standard output file. This item is ignored if the name of the standard output file is not specified. new: Creates a new file. add: Adds information to the existing file. The default is new. |
Y |
|
Standard error |
File name |
Specify the name of the standard error output file existing on the agent host where the job is executed. Length of the value: 1 to 511 bytes |
Y |
Append |
Specify the append option for the standard error output file. This item is ignored if the name of the standard error output file is not specified. new: Creates a new file. add: Adds information to the existing file. The default is new. |
Y |
|
Host name |
Specify the name of the host to which a QUEUE job is submitted. Length of the value: 1 to 255 bytes |
Y |
|
Queue name |
Specify the name of the queue to which a QUEUE job is submitted. Length of the value: 1 to 63 bytes |
Y |
|
Job name |
Specify the name of the job to which a QUEUE job is submitted. Length of the value: 1 to 63 bytes |
Y |
|
Priority |
Specify the priority of job execution. Specifiable value: 1 to 5 (The lowest priority of execution is 1, while the highest priority is 5.) Default: Depends on the definition of the upper-level jobnets. |
Y |
|
End judgment |
Rule |
Specify the type of end judgment.
Default: cod |
Y |
Warning |
Specify the threshold for the end with warning. Specifiable value: 0 to 2,147,483,647 |
Y |
|
Abnormal |
Specify the threshold for the abnormal end. Specifiable value: 0 to 2,147,483,647 Default: 0 |
Y |
|
File name |
Specify the name of the end judgment file existing on the agent host where the job is executed. You can specify an absolute path name or a relative path name from the working path for job execution. This item cannot be specified for a QUEUE job. Length of the value: 1 to 511 bytes |
Y |
|
Retry on abnormal end |
Define whether retrying on an abnormal end is enabled.
Default: No |
Y |
|
Return code |
Lower limit (Greater than or equal to) |
Define the lower limit of the return codes to be retried automatically when automatic retrying is performed for an abnormal end. Specify a value lower than "Upper limit", and higher than "Abnormal". This can be specified only when "Retry on abnormal end" is set to "Yes". Specifiable value: 1 to 4,294,967,295 Default: The default end judgment of "abnormal-threshold + 1" is assumed when execution is performed. |
Y |
Upper limit (Less than or equal to) |
Define the upper limit of the return codes to be retried automatically if automatic retrying is performed for an abnormal end. Specify a value lower than "Lower limit", and lower than "Abnormal". This can be specified only when "Retry on abnormal end" is set to "Yes". Specifiable value: 1 to 4,294,967,295 Default: 4,294,967,295 |
Y |
|
Maximum retry times |
Define the maximum number of retry executions. This can be specified only when "Retry on abnormal end" is set to "Yes". Specifiable value: 1 to 12 (Unit: times) Default: 1 |
Y |
|
Retry interval |
Define the retry interval. This can be specified only when "Retry on abnormal end" is set to "Yes". Specifiable value: 1 to 10 (Unit: minutes) Default: 1 |
Y |
|
User name |
Specify the name of the OS user who executes a job on the agent host. You cannot use a space in the user name. Length of the value: 1 to 63 bytes |
Y |
(13) Judgment job definition information section
Item name |
Description |
Display |
|
---|---|---|---|
Condition |
Define judgment conditions for comparing the end code of the preceding job with the reference value.
Default: gt |
Y |
|
Judgment value |
Retrun code |
Define the judgment end code for judgment. Specifiable value: 0 to 4,294,967,295 This cannot be specified while either "ri","ro","ef","nf","vgt","vge","vlt","vle","veq","vne","vri","vro","sce","spe","sne","snn","snl", or "spn" is specified for "Condition". |
Y |
Return code (Lower limit) |
Define the lower limit judgment return code used in making a judgment. This must be specified if "ri" or "ro" is specified for "Condition". Specifiable value: 0 to 4,294,967,295 This parameter cannot be specified if "ri" or "ro" is not specified for "Condition". |
Y |
|
Variable (number) (Lower limit) |
Define the lower limit judgment value used in making a variable (numeric) judgment. This must be specified if "vri" or "vro" is specified for "Condition". Specifiable value: 0 to 2,147,483,647 This parameter cannot be specified if "vri" or "vro" is not specified for "Condition". |
Y |
|
Judgment Condition (Lower limit) |
Define the boundary conditions used to define the lower limit judgment return code or the lower limit judgment value for variables (numeric).
Specifiable value: Greater than or equal to This parameter cannot be specified if "ri","ro","vri", or "vro" is not specified for "Condition". |
Y |
|
Return code (Upper limit) |
Define the upper limit judgment return code used in making a judgment. This must be specified if "ri" or "ro" is specified for "Condition". Specifiable value: 0 to 4,294,967,295 This parameter cannot be specified if "ri" or "ro" is not specified for "Condition". |
Y |
|
Variable (number) (Upper limit) |
Define the upper limit judgment value used in making a variable (numeric) judgment. This must be specified if "vri" or "vro" is specified for "Condition". Specifiable value: 0 to 2,147,483,647 This parameter cannot be specified if "vri" or "vro" is not specified for "Condition". |
Y |
|
Judgment Condition (Upper limit) |
Define the boundary conditions used to define the upper limit judgment return code or the upper limit judgment value for variables (numeric).
Default: Less than or equal to This parameter cannot be specified if "ri","ro","vri", or "vro" is not specified for "Condition". |
Y |
|
Variable (char.) |
Define the judgment value (character) to be used as the judgment criterion. Length of the value: 1 to 511 bytes This parameter cannot be specified if "gt","ge","lt","le","eq","ne","ri","ro","ef","nf","vgt","vge","vlt","vle","veq","vne","vri","vro","snn", or "snl" is not specified for "Condition". |
Y |
|
Variable (number) |
Define the judgment value (number) to be used as the judgment criterion. Specifiable value: 0 to 2,147,483,647 Default: 0 This parameter cannot be specified if "gt","ge","lt","le","eq","ne","ri","ro","ef","nf","vri","vro","sce","spe","sne","snn","snl" or "spn" is not specified for "Condition". |
Y |
|
Variable |
Specify the macro variable name specified in the preceding job. Make the specification in the "?AJS2xxxxx?" format. You can specify only upper-case alphabetic characters, numeric characters, and periods (.) for xxxxx. Length of the value: 1 to 64 bytes This parameter cannot be specified if "gt","ge","lt","le","eq","ne","ri","ro","ef", or "nf" is not specified for "Condition". |
Y |
|
File name |
Define the file name of a file subject to end judgment. Length of the value: 1 to 260 bytes This parameter cannot be specified if "gt","ge","lt","le","eq","ne","ri","ro","vgt","vge","vlt","vle","veq","vne","vri","vro","sce","spe","sne","snn","snl", or "spn" is not specified for "Condition". |
Y |
(14) Event job definition information section
Item name |
Description |
Display |
|
---|---|---|---|
Waiting time |
Specify the number of minutes to wait for the execution interval control job. Specifiable value: 1 to 1,440 minutes Default: 10 |
Y |
|
Expire right after starting |
Define whether the event job expires immediately after starting. This can be defined if a unit is under start conditions. No: The job is not completed immediately after it is started. Yes: Completes the job immediately after it is started. Default: No Note that when you import a unit that does not expire, the value of the cell is empty. |
Y |
|
Monitoring file |
Specify the name of the monitoring file for the file monitoring job. You can specify a full-path file name or a generic file name using the wildcard (*). Length of the value: 1 to 255 bytes |
Y |
|
Monitoring options |
Options |
Specify the monitoring conditions for the file monitoring job You can specify multiple values. However, you cannot specify s together with m. The values you can specify are as follows: c: Monitors file creation. d: Monitors file deletion. s: Monitors file resizing. m: Monitors for a change in the writing time of the last file. c:d: Specifies c and d at the same time. c:s: Specifies c and s at the same time. c:m: Specifies c and m at the same time. d:s: Specifies d and s at the same time. d:m: Specifies d and m at the same time. c:d:s: Specifies c, d, and s at the same time. c:d:m: Specifies c, d, and m at the same time. Default: c |
Y |
Details (Create) |
Specify the way of executing the file creation monitoring when there is a monitoring-target file. You can specify either of the following values:
Default: n |
Y |
|
Monitoring interval |
Specify the interval at which the file monitoring job monitors the target file.
Default: 60 |
Y |
|
Reception event ID |
Specify the ID of the target event of the JP1 event reception monitoring job. Specifiable value: 00000000:00000000 to FFFFFFFF:FFFFFFFF (in hexadecimal) |
Y |
|
Event issue source host |
Specify the name of the host from which JP1 event reception monitoring job events are issued. Length of the value: 1 to 255 bytes |
Y |
|
Reception event message |
Specify a string to be compared to the message portion of the target JP1 events of the JP1 event reception monitoring job. Length of the value: 1 to 1,024 bytes |
Y |
|
Status after close |
Specify the state of the event job after the execution time-out period elapses. This parameter is invalid for a job within the start condition. Use one of the following keywords to specify this item: kl: Killed nr: Ended normally wr: Ended with warning an: Ended abnormally Default: kl |
Y |
(15) Action job definition information section
Item name |
Description |
Display |
---|---|---|
Send event ID |
Specify the ID of the event transmitted by the JP1 event transmission job. Specifiable value: 00000000 to 00001FFF or 7FFF8000 to 7FFFFFFF (in hexadecimal) |
Y |
Event destination host |
Specify the name of the host to which the JP1 event transmission job sends events. Length of the value: 1 to 255 bytes |
Y |
Send event message |
Specify the message to be attached to events transmitted by the JP1 event transmission job. Length of the value: 1 to 1,023 bytes |
Y |
Send event level |
Specify the event level to be attached to events transmitted by the JP1 event transmission job. Use one of the following keywords to specify this item: em: Sets Emergency. al: Sets Alert. cr: Sets Critical. er: Sets Error. wr: Sets Warning. no: Sets Notice. in: Sets Information. db: Sets Debug. Default: no |
Y |
Check event arrivals |
Specify whether to check the arrival of the event. y: Checks the arrival of the event. n: Does not check the arrival of the event. Default: n |
Y |
Check interval |
Specify the interval at which to check for arrival of a JP1 event. Specifiable value: 3 to 600 (seconds) |
Y |
Check count |
Specify how many times to check for arrival of a JP1 event. Specifiable value: 0 to 999 |
Y |
Platform |
Specify the type of the platform for executing the JP1 event transmission job. p: Windows u: UNIX Default: p |
Y |
(16) Job common attribute information section
Item name |
Description |
Display |
|
---|---|---|---|
Executed by |
Specify the JP1 user who executes the job. This item is invalid for event jobs. Use either of the following keywords to specify this item:
Default: ent |
Y |
|
Time period |
Specify the timeout period for job execution in minutes from the execution start time. This parameter is invalid for jobs within the start conditions. Specifiable value: 1 to 1,440 (minutes) |
Y |
|
Time-required-for-execution |
Define the time required for execute a job for which the termination delay is monitored. Specifiable value: 1 to 1,440 (minutes) |
Y |
|
Exec. service |
Specify whether the job has the queuing attribute. q: Has the queuing attribute. n: Does not have the queuing attribute. Default: q |
Y |
|
Transfer file 1 |
File to transfer |
Define the file to transfer by the full path name. This could be specified in a UNIX job, in a PC job, in a QUEUE job, and their recovery job. Length of the value: 1 to 511 bytes |
Y |
Destination file |
Define the distiname file in the agent host. This could be specified in a UNIX job, in a PC job, in a QUEUE job, and their recovery job. Length of the value: 1 to 511 bytes |
Y |
|
Auto-del |
Defines the automatic deletion of the destination file. This could be defined for a UNIX job, a PC job, or their recovery jobs. This cannot be specified for a QUEUE job. sav: Save the file. del: Delete the file. |
Y |
|
Transfer file 2 |
File to transfer |
Define the file to transfer by the full path name. This could be specified in a UNIX job, in a PC job, in a QUEUE job, and their recovery job. Length of the value: 1 to 511 bytes |
Y |
Destination file |
Define the distiname file in the agent host. This could be specified in a UNIX job, in a PC job, in a QUEUE job, and their recovery job. Length of the value: 1 to 511 bytes |
Y |
|
Auto-del |
Defines the automatic deletion of the destination file. This could be defined for a UNIX job, a PC job, or their recovery jobs. This cannot be specified for a QUEUE job. sav: Save the file. del: Delete the file. |
Y |
|
Transfer file 3 |
File to transfer |
Define the file to transfer by the full path name. This could be specified in a UNIX job, in a PC job, in a QUEUE job, and their recovery job. Length of the value: 1 to 511 bytes |
Y |
Destination file |
Define the distiname file in the agent host. This could be specified in a UNIX job, in a PC job, in a QUEUE job, and their recovery job. Length of the value: 1 to 511 bytes |
Y |
|
Auto-del |
Defines the automatic deletion of the destination file. This could be defined for a UNIX job, a PC job, or their recovery jobs. This cannot be specified for a QUEUE job. sav: Save the file. del: Delete the file. |
Y |
|
Transfer file 4 |
File to transfer |
Define the file to transfer by the full path name. This could be specified in a UNIX job, in a PC job, in a QUEUE job, and their recovery job. Length of the value: 1 to 511 bytes |
Y |
Destination file |
Define the distiname file in the agent host. This could be specified in a UNIX job, in a PC job, in a QUEUE job, and their recovery job. Length of the value: 1 to 511 bytes |
Y |
|
Auto-del |
Defines the automatic deletion of the destination file. This could be defined for a UNIX job, a PC job, or their recovery jobs. This cannot be specified for a QUEUE job. sav: Save the file. del: Delete the file. |
Y |
(17) Waiting condition definition information section
Item name |
Description |
Display |
---|---|---|
Waiting-target units |
Specify the full path name of a unit whose end is being waited for. When you set the preceding wait condition, make sure that you specify this item. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Length of the value: 1 to 930 bytes To release the existing connection, input :X after the unit name (like sample:X). To delete all of the existing preceding wait target units, omit this value. |
Y |
Wait method |
Specify the wait method of the specified units whose ends are being waited for.
Default: and |
Y |
No generations to wait for |
Specify the behavior when there are no generations of the root jobnet for the specified unit whose end is being waited for.
Default: Do not execute |
Y |
When Unmonitored + Ended |
Define how the system behaves if the monitoring of a monitoring generation could not be started.
Default: Do not execute |
Y |
Abnormal end for an execution generation |
Specify how the system behaves if the execution generation terminates abnormally.
Default: Do not execute |
Y |
(18) Tool unit definition information section
Item name |
Description |
Display |
|
---|---|---|---|
Passing information |
Regular expression |
Specify the conditions for extracting the value set in the output macro variable as a regular expression. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Length of the value: 1 to 64 bytes |
Y |
Output macro variable# |
Specify the output macro variable. Make the specification in the "?AJS2xxxxx?" format. You can specify only upper-case alphabetic characters, numeric characters, and periods (.) for xxxxx. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Length of the value: 1 to 64 bytes |
Y |
- #
-
When the output macro variable includes a single-byte space, the space is removed for export and the information is defined. Note that the output macro variable in the export execution result file still includes a single-byte space (the specified value does not change). If you want to identify the output macro variable that uses a single-byte space, use the error-checking function.
(19) Other definition information section
Item name |
Description |
Display |
---|---|---|
Other definition information |
Define definition information not display in the list in the unit definition parameter format.
|
Y |
(20) Custom job definition information section
The custom job definition information section includes the R/3 job definition information section, which defines the details of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. This subsection shows only the information to be specified. For details about how to specify each definition item, see the manual Job Management Partner 1/Automatic Job Management System 3 for Enterprise Applications Description, User's Guide and Reference or Job Management Partner 1/Automatic Job Management System 2 for Enterprise Applications Description, User's Guide and Reference.
(a) R/3 job definition information section
Item name |
Description |
Display |
|
---|---|---|---|
Host name |
Specify the host name to be specified in the -h command argument of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. Length of the value: 1 to 100 bytes |
N |
|
System number |
Specify the system number to be specified in the -s command argument of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. Specifiable value: 0 to 99 |
N |
|
Destination |
Specify the destination to be specified in the -d command argument of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. Length of the value: 1 to 64 bytes |
N |
|
Client |
Specify the client to be specified in the -c command argument of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. Specifiable value: 0 to 999 |
N |
|
SAP user name |
Specify the user name to be specified in the -u command argument of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. You cannot use lower-case alphabetic characters for a user name. Length of the value: 1 to 12 bytes |
N |
|
Password#1 |
Specify the password to be specified in the -p command argument of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. Length of the value: 1 to 10 bytes |
N |
|
Extended password#1 |
Specify the extension password to be specified in the -p2 command argument of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. Length of the value: 1 to 40 bytes |
N |
|
Job name |
Specify the job name to be specified in the -jn argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. You cannot use lower-case alphabetic characters for a job name. Length of the value: 1 to 32 bytes |
N |
|
Job step |
Program type |
Specify the program type in the job steps in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). pa: ABAP program px: External program |
N |
Program |
In the jr3bjsub command of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications, use the -pa argument to specify an ABAP program, or use the -px argument to specify an external program. For an ABAP program, you cannot use lower-case alphabetic characters. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter).
|
N |
|
Variant |
In the jr3bjsub command of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications, use either the -var argument or -arg argument to specify a variant. For an ABAP program, you cannot use lower-case alphabetic characters. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter).
|
N |
|
Authorized user |
Specify the authorized user to be specified in the -auth argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. You cannot use lower-case alphabetic characters to specify the authorized user. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Number of characters that can be specified on one line: 1 to 12 bytes |
N |
|
Target host |
Specify the host name to be specified in the -xpgtgh argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Number of characters that can be specified on one line: 1 to 32 bytes |
N |
|
Archiving mode |
Specify the archiving mode to be specified in the -armode argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Use one of the following keywords to specify this item: P: Printing only A: Archiving only PA: Printing and archiving Default: P |
N |
|
Output device |
Specify the output device to be specified in the -out argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. You cannot use lower-case alphabetic characters for the output device. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Number of characters that can be specified on one line: 1 to 4 bytes |
N |
|
lines |
Specify the number of output lines to be specified in the -ln argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Specifiable value: 1 to 255 (lines) |
N |
|
columns |
Specify the number of output columns to be specified in the -col argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Specifiable value: 1 to 255 (columns) |
N |
|
Format |
Specify the format to be specified in the -fmt argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. You cannot use lower-case alphabetic characters for the format. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Specifiable value: 1 to 16 bytes |
N |
|
Number of copies |
Specify the number of copies to be specified in the -cc argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Specifiable value: 1 to 255 (copies) Default: 1 |
N |
|
Authorization |
Specify the authorization to be specified in the -shwpwd argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. You cannot use lower-case alphabetic characters for the authorization. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Number of characters that can be specified on one line: 1 to 12 bytes |
N |
|
Spool save period |
Specify the spool save period to be specified in the -rpd argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Use a value (n) or keyword to specify this item. n: Specify the number of days during which print requests are to be saved. The value that can be specified in n: 1 to 8 (days) unlimited: Specify this keyword to save print requests without any limit. Default: 8 |
N |
|
SAP cover sheet |
Specify the print option for the SAP cover sheet to be specified in the -sapcvr argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Use one of the following keywords to specify this item: Y: Prints the SAP cover sheet. N: Does not print the SAP cover sheet. D: Depends on the printer setting. Default: D |
N |
|
Receiver |
Specify the receiver to be specified in the -receiver argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. You cannot use lower-case alphabetic characters for the receiver. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Number of characters that can be specified on one line: 1 to 12 bytes |
N |
|
Obj. type |
Specify the object type to be specified in the -objtyp argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. You cannot use lower-case alphabetic characters for the object type. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Number of characters that can be specified on one line: 1 to 10 bytes |
N |
|
Doc. type |
Specify the document type to be specified in the -doctyp argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. You cannot use lower-case alphabetic characters for the document type. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Number of characters that can be specified on one line: 1 to 10 bytes |
N |
|
Information |
Specify the information ID to be specified in the -info argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Number of characters that can be specified on one line: 1 to 3 bytes |
N |
|
Information text |
Specify the information text to be specified in the -text argument of the jr3bjsub command in JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. You cannot use lower-case alphabetic characters for the information text. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). Number of characters that can be specified on one line: 1 to 40 bytes |
N |
|
Other job step information |
Specify the job step information, which is not displayed in the list, of the jr3bjsub command of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. Specify the parameter by using the command argument format. When specifying multiple entries, be sure to do so in the same cell, separating each entry with a line break (Alt+Enter). |
N |
|
Other R/3 job definition information#2 |
Specify the arguments, which are not displayed in the list, of the jr3bjsub command of JP1/AJS3 for Enterprise Applications or JP1/AJS2 for Enterprise Applications. Specify the arguments by using the command argument format. Do not specify the job step information. |
N |
- #1
-
The password is not scrambled and is displayed as is.
- #2
-
Line breaks included in the value are deleted, and the value is handled as one-line data.