Job Management Partner 1/Automatic Job Management System 3 Command Reference 1

[Contents][Glossary][Index][Back][Next]

ajsrelease

Format

ajsrelease
     [-F service-name]
     {-a release-target-root-jobnet-name
        -rid release-ID [-rcm release-comment]
        -rdy release-date [-rti release-time]
        -ru release-source-root-jobnet-name |
      -c release-target-root-jobnet-name |
      -i release-target-root-jobnet-name...}

Format1 (for making release entry)

ajsrelease
     [-F service-name]
     -a release-target-root-jobnet-name
     -rid release-ID
     [-rcm release-comment]
     -rdy release-date
     [-rti release-time]
     -ru release-source-root-jobnet-name

Format2 (for making release cancellation)

ajsrelease
     [-F service-name]
     -c release-target-root-jobnet-name

Format3 (for outputting release information)

ajsrelease
     [-F service-name]
     -i release-target-root-jobnet-name...

Description

The ajsrelease command can be used to perform the following operations on a root jobnet:

Execution privileges

You must have any of the following JP1 privileges:

For making release entry or release cancellation:
  • JP1_AJS_Admin privilege
  • JP1_AJS_Manager privilege
  • JP1_AJS_Editor privilege andJP1_AJS_Operator privilege

For outputting release information:
  • 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 scheduler service in which the target root jobnet (the release-target root jobnet) has been defined.

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

-a release-target-root-jobnet-name

Specify this option when making release entry.

Specify the full name of the release target root jobnet, which has the definitions to be switched to the new definition.

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

You can specify this option only if the release target root jobnet does not have jobnet definitions in Release wait, Delete wait, or Release entry wait status.

If the specified root jobnet does not exist, an error occurs. You cannot specify the following root jobnets:

-c release-target-root-jobnet-name

Specify this option when canceling the switching of the jobnet definition to a jobnet definition for which release entry is made.

Specify the full name of the root jobnet for which you want to cancel the switching of the definition.

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

If you specify this option, the command deletes the jobnet definitions in the Release wait, Delete wait, and Release entry wait statuses.

-i

Specify this option to output release information for the root jobnet.

If you specify this option, the command outputs information about the jobnet definitions in Being applied, Release wait, Delete wait, and Release entry wait statuses as release information. The command does not output release information about the jobnet definitions in other statuses.

-rid release-ID

Specify the release ID of the root jobnet (release-target root jobnet) definition for which the command is to be executed. You can specify a character string of 1 to 30 bytes.

You must specify this option with the -a option.

You must specify this option if you specify the -a option.

You cannot specify the following release IDs:

You cannot specify this option with the -c and -i option.

-rcm release-comment

Specify a comment on the release entry you are making.

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

You must specify this option with the -a option.

You cannot specify this option with the -C and -i option.

If you omit this option, no release comment is registered.

-rdy release-date

Specify in the YYYY/MM/DD format the date on which the jobnet definition will be switched.

You can specify a value in the range from 1994/01/01 to 2036/12/31.

You must specify this option if you specify the -a option.

You cannot specify this option with the -c and -i option.

If you specify a date in the past, an error occurs. An error also occurs if you specify the same date as the release date of a jobnet definition for which release entry is already made.

-rti release-time

Specify in the hh:mm format the time at which the jobnet definition will be switched.

You can specify a value in the range from 00:00 to 23:59. If you omit this option, the system assumes 00:00.

You must specify this option with the -a option.

You cannot specify this option with the -c and -i option.

If you specify a time in the past, an error occurs.

-ru release-source-root-jobnet-name

Specify the full name of the release source root jobnet, the definition of which is to be applied to another root jobnet.

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

You cannot specify any of the following root jobnets:

You must specify this option if you specify the -a option.

You cannot specify this option with the -c and -i option.

release-target-root-jobnet-name...

Specify the root jobnets for which you want to switch the definition.

You can specify multiple units or wildcard characters of units.

You cannot specify a character string that contains a logical host name, service name, or execution ID.

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

You must specify this option if you specify the -i option.

You cannot specify this option with the -a and -c option.

Return values

0 Normal end
Multiple of 4 within the range from 4 to 124 Abnormal end

Example 1

In the following example, the command applies the definition of the test-environment/Rel001 jobnet to the /production-environment/unit001/ jobnet as release 001 at 20:00 on August 10, 2010.

 
ajsrelease -F AJSROOT1 -a / production-environment /unit001 -rid 001 -rcm 2010/08/10 release-definition -rdy 2010/08/10 -rti 20:00 -ru / test-environment /Rel001

Example 2

In the following example, the command removes the release entry for the /production-environment/unit001 root jobnet.

 
ajsrelease -F AJSROOT1 -c / production-environment /unit001

Example 3

In the following example, the command displays the release information for the /production-environment/unit001 root jobnet.

 
ajsrelease -F AJSROOT1 -i / production-environment /unit001

Output example

The following shows a sample execution of the command with the -i option specified:

[Figure]

The following shows the meaning of the output.

upper job group name
The name of the upper-level job group is indicated here.

Unit name
Unit names are listed in this column.

Release ID
Release IDs are listed in this column.

Release time
Release times are listed in MM DD YYYY HH:MM format in this column.

Release status
Any of the following release statuses is displayed in this column.
  • release wait :
    The unit is waiting for the new definition to be applied.
  • being applied :
    The jobnet definition registered by release entry is currently applied.
  • delete wait :
    There is a definition for which release cancellation failed.
  • release entry wait :
    There is a definition for which release entry failed. Alternatively, release entry was successful but the status has not changed to Release wait yet.

Release comment
Comments specified when release entry was made are displayed in this column.

Release source jobnet
The name of the release source jobnet whose definition is used as the new definition is displayed in this column.

[Contents][Back][Next]

[Trademarks]

Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.