Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Configuration Guide


21.1.4 Details of unit-attribute profile

In a unit-attribute profile, set the upper-level unit-attribute inheritance function and execution-user fixing function. Create a file for each scheduler service, and set the functions for each unit.

For details about the upper-level unit-attribute inheritance function, see 6.4.1(4) Access permission for creating or copying a unit, or making a release entry in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide. For details about the execution-user fixing function, see 6.4.1(5) Job execution user in the JP1/Automatic Job Management System 3 System Design (Work Tasks) Guide.

For details about how to create a unit-attribute profile, see 21.1.3 Setting up the upper-level unit-attribute inheritance function and execution-user fixing function.

Organization of this subsection

(1) Format

Create a unit-attribute profile for each scheduler service.

The following shows the format of a unit-attribute profile.

@SYS_PROFILE_START
unit_path=full-name-of-the-unit
InheritUnitAttr=upper-level-unit-attribute-inheritance-function-setting-method
FixedExecUser=execution-user-fixing-function-setting-method
@SYS_PROFILE_END

(2) Setting items

The following describes the items that need to be set. Use a linefeed character to separate items.

(a) @SYS_PROFILE_START

The setting on this line is the fixed value @SYS_PROFILE_START, which indicates the start of the unit-attribute profile settings.

The information enclosed by this line and the corresponding @SYS_PROFILE_END constitutes the settings for one unit. To specify information for multiple units, repeatedly specify the information for each enclosed by a @SYS_PROFILE_START and a @SYS_PROFILE_END. You can specify information for a maximum of 128 units.

This item must be set.

Cautionary note

If many units are set in the unit-attribute profile, the memory used by the unit-attribute profile might be insufficient. Use the UNITPROFMEMSIZE environment setting parameter to set the amount of memory that can be used by the unit-attribute profile. Use the following formula to estimate the required memory size.

Size of memory in kilobytes required for the unit-attribute profile = total-number-of-units-set-in-the-unit-attribute-profile x 2

For details about the UNITPROFMEMSIZE environment setting parameter, see 20.4.2(99) UNITPROFMEMSIZE.

(b) unit_path=full-name-of-the-unit

Use a character string of no more than 930 bytes to specify the full name of the unit for which you want to set the upper-level unit-attribute inheritance function and execution-user fixing function. unit_path= is fixed.

You can set any type of unit.

Set a forward slash (/) to enable the unit-attribute profile for all units in the specified scheduler service.

This item must be set.

Even if only this item is specified as shown below, a syntax error will not occur and the setting has the effect that the upper-level unit-attribute inheritance function and the execution-user fixing function are not used. Use the following specification when you want to temporarily suppress the functions.

@SYS_PROFILE_START
unit_path=/
@SYS_PROFILE_END

Because a line beginning with a hash mark (#) is treated as a comment line, the following specification also has the effect that the upper-level unit-attribute inheritance function and the execution-user fixing function are not used.

@SYS_PROFILE_START
unit_path=/
#InheritUnitAttr=all
#FixedExecUser=all
@SYS_PROFILE_END

(c) InheritUnitAttr=upper-level-unit-attribute-inheritance-function-setting-method

Set either of the following values as the method for setting the upper-level unit-attribute inheritance function.

  • entryuser

    The units in the job group or jobnet specified for unit_path=full-name-of-the-unit inherit the owner and JP1 resource group from the upper-level unit. However, for a unit created by copying a job for which User who owns is set for Executed by, the setting of the copy-source unit is retained instead of the setting of the upper unit being inherited.

  • all

    The units in the job group or jobnet specified for unit_path=full-name-of-the-unit inherit the owner and JP1 resource group from the upper-level unit. Even if a unit is created by copying a job for which User who owns is set for Executed by, the unit inherits the setting of the upper unit.

InheritUnitAttr= is fixed.

Specify this setting only if you want to use the upper-level unit-attribute inheritance function.

When you use the upper-level unit-attribute inheritance function, we recommend that you set the same value that is set for FixedExecUser=execution-user-fixing-function-setting-method.

(d) FixedExecUser=execution-user-fixing-function-setting-method

Set either of the following values as the method for setting the execution-user fixing function.

  • entryuser

    The owner of the unit for which the execution-user fixing function has been set is fixed as the user that executes the jobs in the unit specified for unit_path=full-name-of-the-unit. However, for those jobs for which User who owns is set for Executed by, the owner of each job is the execution user.

  • all

    The owner of the unit for which the execution-user fixing function has been set is fixed as the user that executes the jobs in the unit specified for unit_path=full-name-of-the-unit. This also holds true for jobs for which User who owns is set for Executed by.

FixedExecUser= is fixed.

Specify this setting only if you want to use the execution-user fixing function.

When you use the execution-user fixing function, we recommend that you set the same value that is set for InheritUnitAttr=upper-level-unit-attribute-inheritance-function-setting-method.

(e) @SYS_PROFILE_END

The setting on this line is the fixed value @SYS_PROFILE_END, which indicates the end of the unit-attribute profile settings.

This item must be set.

(3) Example

The following are examples of specifying unit-attribute profiles.

(a) When setting a unit-attribute profile for all units in a scheduler service

Suppose that you want to set a unit-attribute profile for all units in a scheduler service as described in the following table:

Table 21‒5: Example 1

Target unit

Upper-level unit-attribute inheritance function

Execution-user fixing function

All units in the scheduler service

Used (setting: all)

Used (setting: all)

Write the unit-attribute profile as follows.

@SYS_PROFILE_START
unit_path=/
InheritUnitAttr=all
FixedExecUser=all
@SYS_PROFILE_END

(b) When setting a unit-attribute profile for multiple unit paths

Suppose that you want to set a unit-attribute profile for multiple paths as described in the following table:

Table 21‒6: Example 2

Target unit

Upper-level unit-attribute inheritance function

Execution-user fixing function

Units in job group /Grp1

Used (setting: entryuser)

Used (setting: entryuser)

Units in jobnet /net1

Used (setting: all)

Not used

Write the unit-attribute profile as follows.

@SYS_PROFILE_START
unit_path=/Grp1
InheritUnitAttr=entryuser
FixedExecUser=entryuser
@SYS_PROFILE_END
 
@SYS_PROFILE_START
unit_path=/net1
InheritUnitAttr=all
@SYS_PROFILE_END