Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


ajsdefine

Organization of this page

Format

ajsdefine
     [-F service-name]
     [-S]
     [{-x|-t}]
     [{-i|-e|-f}]
     [-p]
     [-d destination-unit-name]
     [unit-definition-file-name...]

Description

Defines a unit based on the parameters coded in a unit definition file.

For details about a unit definition file, see 5.1 Creating a unit definition file.

If you define a unit under a unit for which the upper-level unit-attribute inheritance function is set, a function will set the owner and JP1 resource group of the defined unit. For details on this function, see 6.4.1(4)(a) Overview of the upper-level unit-attribute inheritance function in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

Execution privileges

You must have any of the following JP1 privileges:

Arguments

-F service-name

Specify the name of the target scheduler service.

You can specify a character string of 1 to 30 bytes.

-S

This option makes it possible to update the definitions of nested jobnets and jobs, even for suspended jobnets that have been registered for execution. Even for suspended jobnets, however, you cannot update definitions in the following situations:

  • While the definition of the root jobnet is being updated

  • While the definitions of job groups containing the definition of the root jobnet are being updated

  • While jobnets are being executed

-x

Defines a unit based on the parameters coded in a unit definition file.

-t

Performs only a syntax check for the parameters coded in a unit definition file.

-i

Displays a message with a confirmation prompt if the definition destination contains a unit having the same name as the unit coded in the unit definition file. If you enter y for this prompt, the unit name is forcibly updated.# This option generates an error if the unit definition file contains the specification of units having the same name in the same layer.

#

Delete the unit to be forcibly updated and subordinate units, and then create a unit and code in the unit definition file.

-e

Generates an error without updating information, if the definition destination contains a unit having the same name as the unit coded in the unit definition file. This option generates an error if the unit definition file contains the specification of units having the same name in the same layer. The system does not update information.

-f

Forcibly updates# the unit if the definition destination contains a unit that has the same name as the unit coded in the unit definition. This option generates an error if the unit definition file contains the specification of units having the same name in the same layer.

#

Delete the unit to be forcibly updated and subordinate units, and then create a unit and code in the unit definition file.

-p

When the upper-level unit-attribute inheritance function is enabled, specify this option to ignore the unit-attribute profile when defining the unit.

Specify this option when you want to define units exactly as they appear in a unit definition file output by the ajsprint command.

-d destination-unit-name

Specify the name of the job group or jobnet in which you want to define the unit.

You can specify a character string of 1 to 930 bytes. You cannot specify the logical host name or execution ID. You cannot specify a job group or jobnet for which the number of nested units exceeds 30 (10 if the DEFLENTYPE environment setting parameter is set to sjis), the maximum allowed.

If this option is omitted, the root job group (/) is assumed, in which units will be created.

unit-definition-file-name

Specify the name of the file in which you defined the unit definition parameters (attributes of the unit).

You can specify a character string of 1 to 255 bytes.

You can specify more than one unit definition file. You cannot use wildcard characters here.

If the coding of any unit definition file is invalid, the system stops processing that file but continues processing other files.

If you omit this option, the system inputs the unit definition parameters from the standard input.

Notes

Return values

0

Normal end

Multiple of 4 within the range from 4 to 124

Abnormal end

Additional information

If the window position is not specified for units to be defined, they are automatically located in an empty space on the Jobnet Editor window in JP1/AJS3 - View (somewhere from the top left to the bottom right).

Example

The following command defines a unit in job group /group1 based on the parameters coded in unit definition file /tmp/unit_def:

ajsdefine -d /group1 /tmp/unit_def