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

ajschgjob

Format

ajschgjob
     [-F service-name]
     [job-common-information-change-options]
     [UNIX/PC/QUEUE/CUSTOM-job-information-change-options]
     [judgment-job-information-change-options]
     [JP1-event-reception-monitoring-job-information-change-options]
     [file-monitoring-job-information-change-options]
     [email-reception-monitoring-job-information-change-options]
     [message-queue-reception-monitoring-job-information-change-options]
     [MSMQ-reception-monitoring-job-information-change-options]
     [log-file-monitoring-job-information-change-options]
     [Windows-event-log-monitoring-job-information-change-options]
     [execution-interval-control-job-information-change-options]
     [JP1-event-sending-job-information-change-options]
     [email-sending-job-information-change-options]
     [message-queue-sending-job-information-change-options]
     [MSMQ-sending-job-information-change-options]
     [HP-NNM-status-report-job-information-change-options]
     [local-power-control-job-information-change-options]
     [remote-power-control-job-information-change-options]
     [-R]
     [-L|-E]
     [-J]
     job-name-or-jobnet-name-or-job-group-name...

Description

Modifies the definitions of jobs.

Execution privileges

You must have any of the following JP1 privileges:

JP1_AJS_Admin privilege

JP1_AJS_Manager privilege

JP1_AJS_Editor privilege

Cautionary note

If User who owns is specified for Executed by for the unit, any JP1 user who has a JP1 privilege level for the jobnet other than JP1_AJS_Admin can only modify a unit he or she owns.

If no JP1 resource group is specified for the unit, any user can perform any operation for the unit even if they do not have the above JP1 privilege level.

Arguments

-F service-name

Specify the name of the target scheduler service.

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

-R

Modifies the definitions of all jobs contained in the specified unit.

If you specify this option with the -L, -E, and/or -J options, the system modifies the definitions according to the specification of each option.

-L

Modifies the definitions of jobs in jobnets not registered for execution.

If you specify this option with the -J option, the system modifies the definitions of jobs in unregistered jobnets. You cannot specify this option with the -E option.

-E

Modifies the definitions of jobs in jobnets registered for execution.

If you specify this option with the -J option, the system modifies the definitions of jobs in registered jobnets. You cannot specify this option with the -L option.

-J

Modifies the definitions of jobs.

job-name-or-jobnet-name-or-job-group-name

Specify the full name of the job for which you want to modify definitions. You can also specify the full name of the job, jobnet, or job group with the -R, -E, -L, or -J option.

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

You can specify more than one job name, jobnet name, or job group names.

You can specify a logical host name as a job, jobnet or job group name. You cannot specify an execution ID.

job-common-information-change-options

These options modify information common to all jobs.

-ex "execution-agent-host-name"

Modifies the name of the job execution agent host.

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

You cannot specify this option for a QUEUE job, judgment job, or OR job.

-et execution-time-out-period

Modifies the execution time-out period.

You can specify a value between 1 and 1,440 for the minute.

You cannot specify this option for a QUEUE job, judgment job, or OR job. The same is applicable to any job within the start conditions.

-ha {y|n}

Modifies the hold attribute.

You cannot specify this option for an OR job. The same is applicable to any job within the start conditions.

y
Holds the execution of a job.

n
Does not hold the execution of a job.

-es {kl|nr|wr|an}

Modify the time-out state of the event job after the execution time-out period elapses. This option is valid for the following information change options:

JP1 event reception monitoring job

File monitoring job

Email reception monitoring job

Message-queue message reception monitoring job

MSMQ message reception monitoring job

Log file monitoring job

Windows event-log monitoring job

Execution interval control job

You can specify the following characters with this option:

kl: Killed

nr: Ended normally

wr: Ended with warning

an: Ended abnormally

You can specify this option only for an event job. You cannot specify this option for an event job within the start condition.

If you specify this option for a unit for which no execution time-out period has been specified, you must specify an execution time-out period using the -et option.

-fd time-required-for-execution

Change the time-required-for-execution within which the job is expected to be terminated. A delay of job execution is detected based on this time.

You can specify a value from 1 to 1,440 (in minutes). Specifying a non-numeric character or a numeric value outside the 1-1,440 range results in an error.

You cannot specify this for a judgment job or an OR job. If you specify this option for a judgment job or OR job, the option is ignored and processing continues.

UNIX/PC/QUEUE/CUSTOM-job-information-change-options

These options modify job definition information.

You can specify these options for UNIX jobs, recovery UNIX jobs, PC jobs, recovery PC jobs, custom UNIX jobs, recovery custom UNIX jobs, custom PC jobs, recovery custom PC jobs, QUEUE jobs, and recovery QUEUE jobs.

-te command-text

Modifies a command text.

You can specify a character string of 1 to 1,023 bytes.

You can specify this option for UNIX or Custom UNIX jobs, or recovery jobs for them.

-sc script-file-name

Specify a script file name for a UNIX job, or an execution file name for a PC job and a QUEUE job.

You cannot specify this option for custom PC job or recovery jobs for them.

-pm parameter

Modifies a parameter for the execution file.

You cannot specify this option for custom PC job or recovery jobs for them.

-wk work-path-name

Modifies the work path (current path) name.

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

You cannot specify this option for a QUEUE job, a custom PC job, or recovery jobs for them.

-ev environment-variable-file-name

Modifies the environment variable file name.

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

Use a full path name to specify the environment variable file name.

You cannot specify this option for a QUEUE job, a custom PC job, or recovery jobs for them.

For notes on defining environment variables, see A. Notes on Defining Environment Variables and an Environment Variable File.

-en environment-variable

Modifies the environment variable.

You can specify a character string of 1 to 20,479 bytes.

You can specify more than one environment variable using up to a total of 20,479 bytes.

You cannot specify this option for a QUEUE job, a custom PC job, or recovery jobs for them.

For notes on defining environment variables, see A. Notes on Defining Environment Variables and an Environment Variable File.

-si standard-input-file-name

Modifies the standard input file name.

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

Use a full path name to specify the standard input file name.

You cannot specify this option for a QUEUE job, a custom PC job, or recovery jobs for them.

-so standard-output-file-name

Modifies the standard output file name.

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

Use a full path name to specify the standard output file name.

You cannot specify this option for a QUEUE job or recovery jobs for them.

-se standard-error-output-file-name

Modifies the standard error output file name.

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

Use a full path name to specify the standard error output file name.

You cannot specify this option for a QUEUE job or recovery jobs for them.

-oa {new|add}

Modifies the method for updating the information in the standard output file. You cannot specify this option for a QUEUE job, a custom PC job, or recovery jobs for them.

new
Outputs information to a new standard output file.

add
Adds information to an existing standard output file.

-ea {new|add}

Modifies the method for updating the information in the standard error output file. You cannot specify this option for a QUEUE job, a custom PC job, or recovery jobs for them.

new
Outputs information to a new standard error output file.

add
Adds information to an existing standard error output file.

-pr execution-priority

Modifies the priority for job execution.

You can specify a value between 1 and 5.

The lowest priority is 1 and the highest is 5.

-un job-execution-user-name

Modifies the name of the user for executing the job.

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

You cannot specify this option for a QUEUE job or recovery jobs for them.

-jd {nm|ab|cod|mdf|exf}

Modifies the type of end judgment.

nm
Assumes every termination of the job to be a normal end.

ab
Assumes every termination of the job to be an abnormal end.

cod
Assumes a normal end if the end code is below the specified value.

mdf
Assumes a normal end if the job has updated a file.
You cannot specify this option for a QUEUE job or recovery jobs for them.

exf
Assumes a normal end if the job has created a file.
You cannot specify this option for a QUEUE job or recovery jobs for them.

-wt warning-threshold

Modifies the threshold value for completion with a warning.

You can specify a value between 0 and 2,147,483,647.

The system assumes the abnormal threshold value if you specify any value greater than the threshold value.

-th abnormal-threshold

Modifies the threshold value for abnormal end.

You can specify a value between 0 and 2,147,483,647.

The system assumes the warning threshold value if you specify any value smaller than the threshold value.

-jf end-judgment-file-name

Modifies the name of the end judgment file.

You cannot specify this option for a QUEUE job or recovery jobs for them.

-qu queue-name

Modifies the name of the queue for queuing the job.

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

You can specify this option for QUEUE job or recovery jobs for them.

-qm queue-manager-host-name

Modifies the name of the queue manager host.

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

You can specify this option for QUEUE job or recovery jobs for them.

-rq job-name

Modifies the job name.

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

You can specify this option for QUEUE job or recovery jobs for them.

-s1 transfer-source-file-name-1

Modifies transfer source file name 1.

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

You cannot specify this option for custom PC job or recovery jobs for them.

-d1 transfer-destination-file-name-1

Modifies transfer destination file name 1.

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

You cannot specify this option for custom PC job or recovery jobs for them.

-t1 {sav|del}

Modifies the option for deleting transfer destination file 1 upon the completion of job execution. You cannot specify this option for a QUEUE job, a custom PC job, or recovery jobs for them.

sav
Saves the file upon the completion of job execution.

del
Deletes the file upon the completion of job execution.

-s2 transfer-source-file-name-2

Modifies transfer source file name 2.

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

You cannot specify this option for custom PC job or recovery jobs for them.

-d2 transfer-destination-file-name-2

Modifies transfer destination file name 2.

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

You cannot specify this option for custom PC job or recovery jobs for them.

-t2 {sav|del}

Modifies the option for deleting transfer destination file 2 upon the completion of job execution. You cannot specify this option for a QUEUE job, a custom PC job, or recovery jobs for them.

sav
Saves the file upon the completion of job execution.

del
Deletes the file upon the completion of job execution.

-s3 transfer-source-file-name-3

Modifies transfer source file name 3.

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

You cannot specify this option for custom PC job or recovery jobs for them.

-d3 transfer-destination-file-name-3

Modifies transfer destination file name 3.

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

You cannot specify this option for custom PC job or recovery jobs for them.

-t3 {sav|del}

Modifies the option for deleting transfer destination file 3 upon the completion of job execution. You cannot specify this option for a QUEUE job, a custom PC job, or recovery jobs for them.

sav
Saves the file upon the completion of job execution.

del
Deletes the file upon the completion of job execution.

-s4 transfer-source-file-name-4

Modifies transfer source file name 4.

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

You cannot specify this option for custom PC job or recovery jobs for them.

-d4 transfer-destination-file-name-4

Modifies transfer destination file name 4.

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

You cannot specify this option for custom PC job or recovery jobs for them.

-t4 {sav|del}

Modifies the option for deleting transfer destination file 4 upon the completion of job execution.

You cannot specify this option for a QUEUE job, a custom PC job, or recovery jobs for them.

sav
Saves the file upon the completion of job execution.

del
Deletes the file upon the completion of job execution.

-jt {q|n}

Modify whether the job has the queuing attribute. You can specify this option for UNIX or PC jobs, or recovery jobs for them. You cannot specify this option for a QUEUE job or recovery jobs for them.

q
Has the queuing attribute.

n
Does not have the queuing attribute.

judgment-job-information-change-options

These options modify definition information for a judgment job.

-ej {gt|ge|lt|le|eq|ne|ef|nf|vgt|vge|vlt|vle|veq|vne|sce|spe|sne|snn|snl}

This option is used to modify the judgment method.

gt
Indicates that the end code for the preceding job is greater than the judgment value.

ge
Indicates that the end code for the preceding job is greater than or equal to the judgment value.

lt
Indicates that the end code for the preceding job is less than the judgment value.

le
Indicates that the end code for the preceding job is less than or equal to the judgment value.

eq
Indicates that the end code for the preceding job is equal to the judgment value.

ne
Indicates that the end code for the preceding job is not equal to the judgment value.

ef
Indicates that the job has created a file.

nf
Indicates that the job has not created a file.

vgt
Indicates that the value of the specified variable is greater than the judgment value (numeric).

vge
Indicates that the value of the specified variable is equal to or greater than the judgment value (numeric).

vlt
Indicates that the value of the specified variable is less than the judgment value (numeric).

vle
Indicates that the value of the specified variable is equal to or less than the judgment value (numeric).

veq
Indicates that the value of the specified variable is equal to the judgment value (numeric).

vne
Indicates that the value of the specified variable is not equal to the judgment value (numeric).

sce
Indicates that the value of the specified variable is equal to the judgment value (string).

spe
Indicates that the value of the specified variable includes the judgment value (string).

sne
Indicates that the value of the specified variable is not equal to the judgment value (string).

snn
Indicates that the value of the specified variable does exist.

snl
Indicates that the value of the specified variable does not exist.

-ec judgment-end-code

Modifies the end code used for judgment.

You can specify a value between 0 and 4,294,967,295.

-ef end-judgment-file-name

Modifies the name of the file used for judgment.

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

-jV variable-name

Changes the variable name serving as the target of judgment.

You can specify a string of 1 to 64 bytes in ?AJS2xxxxx? format. What you can specify in the xxxxx part is limited to upper-case alphabetic characters, numeric characters, and periods (.).

-jT string-of-judging-variable

Changes the string serving as the target of variable judgment.

You can specify a string of 1 to 511 bytes.

-jI numerical-value-of-judging-variable

Changes the numerical value serving as the target of variable judgment.

You can specify a value of 0 to 2,147,483,647.

JP1-event-reception-monitoring-job-information-change-options

These options modify definition information for a JP1 event reception monitoring job.

-jp macro-variable-specification

Modifies the specification of a macro variable.

You can specify more than one macro variable in the following format: -jp ?AJS2xxxxxxxxx?:take-over-information.

If you specify the same macro variable more than once, however, take-over-information is valid only for the first specified macro variable.

You can only specify uppercase letters, numbers and periods for the xxxxxxxxx section. You can specify a character string of 1 to 64 bytes for the ?AJS2xxxxxxxxx? section.

You can specify a character string of up to 2,048 bytes in total. This means that the sum of the number of bytes should not exceed 2,048 after the value of the -jp option is converted to the jpoif=?AJS2xxxxxxxxx?:take-over-information; format that is output with the ajsprint -a option.

You can specify the following character strings for take-over-information:

CMTMOUT: Whether the job has ended due to time-out

EVID: Event ID

EVUSR: Event issuer user name

EVGRP: Event issuer group name

EVHOST: Event issuer event server name

EVIPADDR: Event issuer IP address

EVMSG: Message information

EVDETAIL: Event detail information

EVSEV: Extended attribute event level

EV: extended-attribute-name: Arbitrary extended attribute

EVENV1 to EVENV9: Retrieved data

EVUSRID: Event issuer user ID

EVGRPID: Event issuer group ID

EVPROCESSID: Event issuer process ID

EVDATE: Date of event issue

EVTIME: Time of event issue

-EI monitoring-event-ID

Modifies the monitoring event ID.

You can specify a hexadecimal value between 00000000:00000000 and FFFFFFFF:FFFFFFFF.

-EU event-source-user-name

Modifies the name of the user issuing an event.

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

-EG event-source-group-name

Modifies the name of the group issuing an event.

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

-EH event-source-host-name

Modifies the name of the host issuing an event.

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

-Ei event-source-IP-address

Modifies the IP address of the event source.

You can specify a value between 0.0.0.0 and 255.255.255.255 in the XXX.YYY.xxx.yyy format. You can specify a value between 0 and 255 for each of XXX, YYY, xxx and yyy.

-EM event-message-information

Modifies the event message information.

You can specify characters or a regular expression of 1 to 1,024 bytes.

-ED event-detail-information

Modifies the event detail information.

You can specify characters or a regular expression of 1 to 1,024 bytes.

-ES event-level

Modifies the event level, which is one of the event extended attributes.

You can specify the following character strings. You can specify multiple event levels delimited with ":", such as -ES em:al.

em: Uses Emergency as the matching criteria.

al: Uses Alert as the matching criteria.

cr: Uses Critical as the matching criteria.

er: Uses Error as the matching criteria.

wr: Uses Warning as the matching criteria.

no: Uses Notice as the matching criteria.

in: Uses Information as the matching criteria.

db: Uses Debug as the matching criteria.

-EF any-event-extended-attribute

Modifies any event extended attribute.

You can specify more than one attribute in the following format:

-EF "any-event-extended-attribute-name:\"value\""

If the value contains double quotation marks (") or #, use a cast character (#). Specify #\" for " and ## for #.

You can specify a character string of up to 2,048 bytes in total. This means that the sum of the number of bytes should not exceed 2,048 after the value specified in the -EF option is converted to the evwfr=any-event-extended-attribute-name:"value"; format that is output with the ajsprint -a option.

-ET end-judgment-condition

Modifies the end judgment condition.

You can specify the following characters:

n: Assumes every termination of the job to be a normal end.

a: Assumes every termination of the job to be an abnormal end.

n:file-name: Assumes a normal end if the message coincides with the contents of the specified file.

a:file-name: Assumes an abnormal end if the message coincides with the contents of the specified file.

d:file-name: Assumes a normal end if the detailed information coincides with the contents of the specified file.

b:file-name: Assumes an abnormal end if the detailed information coincides with the contents of the specified file.

You can specify a character string of 1 to 256 bytes for the file name.

-Eu event-source-user-ID

Modifies the ID of the user issuing an event.

You can specify a value between -1 to 9,999,999,999.

-Eg event-source-group-ID

Modifies the ID of the group issuing an event.

You can specify a value between -1 to 9,999,999,999.

-Ep event-source-process-ID

Modifies the ID of the process issuing an event.

You can specify a value between -1 to 9,999,999,999.

-Ee {no|minutes}

Specify whether, immediately after the JP1 event reception monitoring job is executed (before starting monitoring for a JP1 event) any previous JP1 events will still be monitored for reception.

no
Does not search for previous JP1 events.

minutes
Searches for JP1 events that occurred after the specified time before the JP1 event reception monitoring job was executed. You can specify a decimal value between 1 and 720 (minutes).
If you specify minutes, ensure that the monitor event ID is already specified with the -EI option.
If you have not specified the monitor event ID, use the -EI option simultaneously to specify the monitor event ID.

file-monitoring-job-information-change-options

These options modify definition information for a file monitoring job.

-jp macro-variable-specification

Modifies the specification of a macro variable.

You can specify more than one macro variable in the following format: -jp ?AJS2xxxxxxxxx?:take-over-information.

If you specify the same macro variable more than once, however, take-over-information is valid only for the first specified macro variable.

You can only specify uppercase letters, numbers and periods for the xxxxxxxxx section. You can specify a character string of 1 to 64 bytes for the ?AJS2xxxxxxxxx? section.

You can specify a character string of up to 2,048 bytes in total. This means that the sum of the number of bytes should not exceed 2,048 after the value of the -jp option is converted to the jpoif=?AJS2xxxxxxxxx?:take-over-information; format that is output with the ajsprint -a option.

You can specify the following character strings for take-over-information:

CMTMOUT: Whether the job has ended due to time-out

FLFNAME: Full-path name of the changed file

FLCOND: Conditional parameter

FLCTIME: Time at which the file was updated

FLSIZE: Size of the changed file

-FF monitored-file-name

Modifies the name of the file to be monitored.

You can specify a character string of 1 to 255 bytes. Use a complete name or wildcard characters to specify the file name. Note, however, that you cannot specify the file name using wildcard characters when a value from 1 to 9 is used to specify the monitor interval in the -FI option.

-FC monitoring-conditions

Modifies the monitoring conditions.

You can specify one or more of the following characters. (Delimit with ":", such as -FC c:d. You cannot, however, specify both s and m in one command.

c: Monitors the creation of a file.

d: Monitors the deletion of a file.

s: Monitors the resizing of a file.

m: Monitors the modification of the last written time for a file.

When you specify the -FO option, also specify the c character.

If you specify the c character without specifying the -FO option, the file monitor job is executed before the system monitors creation of the file to be monitored.

If you delete the c character, the system does not monitor file creation.

-FI monitoring-interval

Modifies the time interval for file monitoring.

You can specify a value between 1 and 600 (seconds). Note, however, that you cannot specify a value from 1 to 9 when the file name using wildcard characters is used to specify the monitor file name in the -FF option.

-FO handling-in-presence-of-file-to-be-monitored

This option changes the way of executing the file monitoring job when there is a file to be monitored. It can be specified only when the monitor conditions contain "Monitor file creation".

You can specify one or more of the following characters.

y: The system terminates normally assuming that the monitor conditions have been met.

n: The system continues to monitor the target file.

email-reception-monitoring-job-information-change-options

These options modify definition information for an email reception monitoring job.

-jp macro-variable-specification

Modifies the specification of a macro variable.

You can specify more than one macro variable in the following format: -jp ?AJS2xxxxxxxxx?:take-over-information.

If you specify the same macro variable more than once, however, take-over-information is valid only for the first specified macro variable.

You can only specify uppercase letters, numbers and periods for the xxxxxxxxx section. You can specify a character string of 1 to 64 bytes for the ?AJS2xxxxxxxxx? section.

You can specify a character string of up to 2,048 bytes in total. This means that the sum of the number of bytes should not exceed 2,048 after the value of the -jp option is converted to the jpoif=?AJS2xxxxxxxxx?:take-over-information; format that is output with the ajsprint -a option.

You can specify the following character strings for take-over-information:

CMTMOUT: Whether the job has ended due to time-out

MLRCVADDRESS: Email sender's address

MLRCVSUBJECT: Email title

MLRCVBODY: File storing email text

MLRCVATTACHFILEnn (nn is a value between 01 and 20): Name of the file attached to the email

MLRCVATTACHLIST: Name of the file containing a list of files attached to the email

MLRCVMAILBODY: Email

MLRCVTIME: Time at which the email arrived

-pf platform-type

Modifies the platform type for defining email reception.

You can specify either of the following characters:

u: Defines email reception under UNIX.

p: Defines email reception under Windows.

-MA sender

Modifies the sender of the received email.

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

You can specify up to 20 senders in the -MA "sender" format.

-ML email-reception-list-name

Modifies the name of the email reception list.

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

-MP profile-name

Modifies the profile name.

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

-Ms email-save-mode

Modifies the mode of saving received email.

You can specify either of the following characters:

y: Saves received email.

n: Does not save received email.

-MS subject

Modifies the subject of the received email.

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

You can specify up to 20 subjects in one command using the -MS "text" format.

-MF folder-to-store-attached-file

Modifies the name of the folder in which you store any attached file of the received email.

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

-mf attached-file-list-file-name

Modifies the name of the file containing a list of attached files.

You can specify a character string of 1 to 256 bytes. Use a full path to specify the list file name.

-Mt file-to-store-email-text

Modifies the name of the file in which you store the text of the received email.

You can specify a character string of 1 to 256 bytes. Use a full path to specify the file name.

-MT text

Modifies the text of the received email.

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

You can specify up to 20 messages in one command in the -MT text format.

message-queue-reception-monitoring-job-information-change-options

These options modify definition information for a message queue reception monitoring job.

-jp macro-variable-specification

Modifies the specification of a macro variable.

You can specify more than one macro variable in the following format: -jp ?AJS2xxxxxxxxx?:take-over-information.

If you specify the same macro variable more than once, however, take-over-information is valid only for the first specified macro variable.

You can only specify uppercase letters, numbers and periods for the xxxxxxxxx section. You can specify a character string of 1 to 64 bytes for the ?AJS2xxxxxxxxx? section.

You can specify a character string of up to 2,048 bytes in total. This means that the sum of the number of bytes should not exceed 2,048 after the value of the -jp option is converted to the jpoif=?AJS2xxxxxxxxx?:take-over-information; format that is output with the ajsprint -a option.

You can specify the following character strings for take-over-information:

CMTMOUT: Whether the job has ended due to time-out

MQRCVCORRELATION: Message correlation ID

MQRCVDISCRIMINATION: Message ID

MQRCVQUEUE: Message reception queue name

MQRCVMODELQUEUE: Model queue name

MQRCVMESSAGEFILE: Message structure storage file name

-QC correlation-ID

Modifies the correlation ID of the received message.

You can specify a character string of 1 to 24 bytes. You can, however, specify only uppercase letters and numbers.

-QD message-ID

Modifies the message ID of the received message.

You can specify a character string of 1 to 24 bytes. You can, however, specify only uppercase letters and numbers.

-QM model-queue-name

Modifies the model queue name for the queue used to monitor message reception.

You can specify a character string of 1 to 48 bytes. Specify the queue name using an MQ character string.

-QQ message-reception-queue-name

Modifies the name of the queue used to monitor message reception.

You can specify a character string of 1 to 48 bytes. Specify the queue name using an MQ character string.

-QS message-storage-file-name

Modifies the name of the file in which you store messages.

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

MSMQ-reception-monitoring-job-information-change-options

These options modify definition information for an MSMQ reception monitoring job.

-jp macro-variable-specification

Modifies the specification of a macro variable.

You can specify more than one macro variable in the following format: -jp ?AJS2xxxxxxxxx?:take-over-information.

If you specify the same macro variable more than once, however, take-over-information is valid only for the first specified macro variable.

You can only specify uppercase letters, numbers and periods for the xxxxxxxxx section. You can specify a character string of 1 to 64 bytes for the ?AJS2xxxxxxxxx? section.

You can specify a character string of up to 2,048 bytes in total. This means that the sum of the number of bytes should not exceed 2,048 after the value of the -jp option is converted to the jpoif=?AJS2xxxxxxxxx?:take-over-information; format that is output with the ajsprint -a option.

You can specify the following character strings for take-over-information:

CMTMOUT: Whether the job has ended due to time-out

MSRCVQUEUEPATH: Message queue path name

MSRCVMUTUAL: Message correlation ID

MSRCVMESSAGELABEL: Message label

MSRCVAPPLICATION: Message application information

MSRCVMESSAGEFILE: Message structure storage file name

-SA application-information

Modifies the application information for the message to be monitored.

You can specify a hexadecimal value between 0 and FFFFFFFF.

-SM message-label

Modifies the message label for the message to be monitored.

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

-SQ queue-path-name

Modifies the queue path name for the queue used to monitor messages.

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

-SR message-correlation-ID

Modifies the correlation ID of the message to be monitored.

You can specify a character string of 1 to 20 bytes. You can, however, specify only uppercase letters and numbers.

-SF message-storage-file-name

Modifies the name of the file in which you store messages.

You can specify a character string of 1 to 256 bytes. Use a full path to specify the file name.

log-file-monitoring-job-information-change-options

These options modify definition information for a log file monitoring job.

-jp macro-variable-specification

Modifies the specification of a macro variable.

You can specify more than one macro variable in the following format: -jp ?AJS2xxxxxxxxx?:take-over-information.

If you specify the same macro variable more than once, however, take-over-information is valid only for the first specified macro variable.

You can only specify uppercase letters, numbers and periods for the xxxxxxxxx section. You can specify a character string of 1 to 64 bytes for the ?AJS2xxxxxxxxx? section.

You can specify a character string of up to 2,048 bytes in total. This means that the sum of the number of bytes should not exceed 2,048 after the value of the -jp option is converted to the jpoif=?AJS2xxxxxxxxx?:take-over-information; format that is output with the ajsprint -a option.

You can specify the following character strings for take-over-information:

CMTMOUT: Whether the job has ended due to time-out

LFFNAME: Trapped log file name

LFDATA: Trapped data

-Lw file-creation-wait-option

Modifies the option for file creation wait at the beginning of log file monitoring job.

You can specify either of the following characters:

y: Generates an error if a log file is not found.

n: Repeats opening a file until a log file is created.

-Ld log-file-output-file-format

Modifies the output file format for the log file.

You can specify the following character strings.

s: Sequential (default). Data is appended to one log file, and when the file is filled to its capacity, a new log file is created with another name, and new log data is written to the new file.

s2: Sequential. A log file with the same name is continuously used for logging by creating a new file with the same name after backing up the current file with another name or deleting the current file.
If the job execution host is a Windows host, you can specify this option in JP1/AJS3 or in JP1/AJS2 08-00 or a later version if the JP1/Base version is 08-10 or later.
If the job execution host is a UNIX host, you can specify this option in JP1/AJS3 or in JP1/AJS2 07-00 or a later version if the JP1/Base version is 07-00 or later.

w1: Wraparound (When log data is written to the end of the log file, the existing data is overwritten with new data, starting with the beginning of the file.)

w2: Wraparound (When log data is written to the end of the log file, the existing data is deleted and then new data is written from the beginning of the file.)

-LF log-file-name

Changes the log file name to be monitored.

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

You can specify up to 8 files in one command in the -LF "log-file-name" format.

-LL header-specification

Modifies the header.

You can specify either of the following characters:

l:number-of-lines-in-header: Modifies the number of lines contained in the header. You can specify a value between 0 and 99, 999 (lines).

s:header-size: Modifies the size of the header. You can specify a size of up to 9,999,999 (bytes).

-LM data-other-than-log-information

Modifies data other than the log information.

You can specify more than one data item in one command using the -LM "[!]\"data-other-than-log-information\"" format.

If the data contains double quotation marks (") or #, use a cast character (#). Specify #\" for " and ## for #.

You can specify a character string of up to 1,024 bytes in total. This means that the sum of the number of bytes should not exceed 1,024 after the value specified in the -LM option is converted to the following format that is output with the ajsprint -a option:

lfmks=[!]"data-1-other-than-log-information"[:[!]"data-2-other-than-log-information"...];

-LX maximum-event-data-length

Modifies the maximum length of event data.

You can specify a character string of 2 to 512 bytes.

-LR log-data-record-format

Modifies the record format of the log data to be trapped.

You can specify either of the following characters:

v:'[\] delimiter': Delimits a line using variable-length records. You can specify the delimiter consisting of a character string of 1 byte.

f:record-length: Delimits a line using fixed-length records. You can specify a value between 1 and 9,999,999 (bytes) for the record length.

-LI log-file-search-interval

Modifies the time interval for log file searching.

You can specify a value between 1 and 86,400 (seconds).

-Ls search-start-option

Modifies the search start option.

You can specify either of the following characters:

y: Inputs from the top data.

n: Does not input from the top data.

-LD trap-data

Modifies the data to be trapped.

You can specify more than one data item in one command using the -LD "[!]\"trap-data\"" format.

If the trap data contains double quotation marks (") or #, use a cast character (#). Specify #\" for " and ## for #.

You can specify a character string of up to 2,048 bytes in total. This means that the sum of the number of bytes should not exceed 2,048 after the value specified in the -LD option is converted to the lftpd=[!]"trap-data-1"[:[!]"trap-data-2"...]; format that is output with the ajsprint -a option.

Windows-event-log-monitoring-job-information-change-options

These options modify definition information for a Windows event log monitoring job.

-jp macro-variable-specification

Modifies the specification of a macro variable.

You can specify more than one macro variable in the following format: -jp ?AJS2xxxxxxxxx?:take-over-information.

If you specify the same macro variable more than once, however, take-over-information is valid only for the first specified macro variable.

You can only specify uppercase letters, numbers and periods for the xxxxxxxxx section. You can specify a character string of 1 to 64 bytes for the ?AJS2xxxxxxxxx? section.

You can specify a character string of up to 2,048 bytes in total. This means that the sum of the number of bytes should not exceed 2,048 after the value of the -jp option is converted to the jpoif=?AJS2xxxxxxxxx?:take-over-information; format that is output with the ajsprint -a option.

You can specify the following character strings for take-over-information:

CMTMOUT: Whether the job has ended due to time-out

NELOG: Log type

NEEVKIND: Event type

NESOURCE: Source

NECLASS: Category

NEEVID: Event ID

NEDETAIL: Description

-NJ event-category-judgment-condition

Modifies the judgment condition for an event category.

You can specify one of the following characters:

y: Monitors the specified category.

n: Monitors the categories other than the specified category.

-NC category

Modifies the category of the events you want to monitor.

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

-ND description

Modifies the description you want to use for comparison when monitoring the detailed description of an event.

You can specify a character string of 1 to 1,024 bytes.

-Ni event-ID-judgment-condition

Modifies the judgment condition for an event ID.

You can specify either of the following characters:

y: Monitors the specified event ID.

n: Monitors the event IDs other than the specified event ID.

-NI event-ID

Modifies the event ID of the events you want to monitor.

You can specify a value between 0 and 4,294,967,295.

-NE event-type

Modifies the event type.

You can specify either of the following characters: You can specify one of the following characters: You can specify multiple types delimited with ":", such as -NE i:w:e.

i: Monitors information events.

w: Monitors warning events.

e: Monitors error events.

s: Monitors successful audit events.

f: Monitors failed audit events.

-NL log-type

Modifies the log type.

You can specify the following character strings.

sys: Monitors the system log.

sec: Monitors the security log.

app: Monitors the application log.

dns: Monitors the DNS Server log (for Windows 2000).

dir: Monitors the Directory Service log (for Windows 2000).

frs: Monitors the file reproduction service log (for Windows 2000).

-Ns source-judgment-condition

Modifies the judgment condition for a source.

You can specify either of the following characters:

y: Monitors the specified source.

n: Monitors the sources other than the specified source.

-NS source

Modifies the source you want to monitor.

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

execution-interval-control-job-information-change-options

This option modifies definition information for an execution interval control job.

-jp macro-variable-specification

Modifies the specification of a macro variable.

You can specify more than one macro variable in the following format: -jp ?AJS2xxxxxxxxx?:take-over-information.

If you specify the same macro variable multiple times, however, take-over-information is valid only for the first specified macro variable.

You can only specify uppercase letters, numbers, and periods for the xxxxxxxxx section.

You can specify a character string of 1 to 64 bytes for the ?AJS2xxxxxxxxx? section.

You can specify a character string of up to 2,048 bytes in total. This means that the sum of the number of bytes should not exceed 2,048 after the value of the -jp option is converted to the jpoif=?AJS2xxxxxxxxx?:take-over-information; format that is output with the ajsprint -a option.

You can specify the following character strings for take-over-information:

CMTMOUT: Whether the job has ended due to time-out

-Tw wait-time

Modifies the wait time.

You can specify a value between 1 and 1,440 for the minute.

JP1-event-sending-job-information-change-options

These options modify definition information for an JP1 event sending job.

-pf platform-type

Modifies the platform type.

You can specify either of the following characters:

u: Operates in a UNIX environment.

p: Operates in a Windows environment.

-EH event-destination-host-name

Modifies the name of the host to which you want to transmit events.

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

-eM message

Modifies the message information you want to attach to the event.

You can specify a character string of 1 to 1,023 bytes.

-eI transmit-event-ID

Modifies the event ID of the event you want to transmit.

You can specify a hexadecimal value between 00000000 and 00001FFF, or between 7FFF8000 and 7FFFFFFF.

-eS event-level

Modifies the event level, which is one of the event extended attributes.

You can specify the following character strings.

em: Specifies Emergency.

al: Specifies Alert.

cr: Specifies Critical.

er: Specifies Error.

wr: Specifies Warning.

no: Specifies Notice.

in: Specifies Information.

db: Specifies Debug.

-Ef any-event-extended-attribute

Modifies any extended attribute attached to the event.

You can specify options in the following format: -Ef "any-extended-attribute-name:\"value\"".

You can specify in the following format:

-Ef "any-event-extended-attribute-name:\"value\""

You can specify more than one attribute (up to 128 bytes in the evsfr=any-event-extended-attribute-name:"value"; format).

If the value contains double quotation marks (") or #, use a cast character (#). Specify #\" for " and ## for #.

-eK {y|n}

Specifies whether to check the arrival of the event.

You can specify either of the following characters:

n: Does not check the arrival of the event.

y: Checks the arrival of the event.

-eP event-arrival-check-interval

Specifies the interval at which arrival checks will be attempted if the JP1 event has not yet arrived.

If the unit definition specifies no event arrival check, you can modify the specification to check arrivals by specifying this option with the -eK y option.

You cannot specify this option with the -eK n option.

You can specify a decimal value between 3 and 600 (seconds).

-eR event-arrival-check-count

Specifies the number of times arrival checks will be attempted if the JP1 event has not yet arrived.

If the unit definition specifies no event arrival check, you can modify the specification to check arrivals by specifying this option with the -eK y option.

You cannot specify this option with the -eK n option.

You can specify a decimal value between 0 and 999 (times).

-jt {q|n}

Changes the queuing attribute type.

q: The queuing attribute exists.

n: The queuing attribute does not exist.

email-sending-job-information-change-options

These options modify definition information for an email sending job.

-pf platform-type

Modifies the platform type.

You can specify either of the following characters:

u: Operates in a UNIX environment.

p: Operates in a Windows environment.

-MA email-address

Modifies the address to which you want to transmit email.

You can specify the following character strings.

to:email-address: Transmits the email to the destination.

cc:email-address: Transmits a copy of the email to the destination.

bcc:email-address: Transmits a copy of the email to the destination using the blind carbon copy feature.

You can specify a character string of 1 to 256 bytes for the email address.

You can specify up to 20 email addresses in one command using the -MA "email-address" format.

-MP profile-name

Modifies the profile name.

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

-MS subject

Modifies the subject of the email to be sent.

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

-mF attached-file-name

Modifies the name of the file you want to attach to the email to be sent.

You can specify a character string of 1 to 256 bytes. You can specify up to 20 files in one command in the -mF "attached-file-name" format. Use a full path to specify the file name.

-mf attached-file-list-file-name

Modifies the name of the file containing a list of attached files.

You can specify a character string of 1 to 256 bytes. Use a full path to specify the list file name.

-MT text

Modifies the text of the email to be sent.

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

-mt text-file-name

Modifies the text file name for the email to be sent.

You can specify a character string of 1 to 256 bytes. Use a full path to specify the file name.

-jt {q|n}

Changes the queuing attribute type.

q: The queuing attribute exists.

n: The queuing attribute does not exist.

message-queue-sending-job-information-change-options

These options modify definition information for a message queue for a sending job.

-pf platform-type

Modifies the platform type.

You can specify either of the following characters:

u: Operates in a UNIX environment.

p: Operates in a Windows environment.

-QC correlation-ID

Modifies the correlation ID of the message to be sent.

You can specify a character string of 1 to 24 bytes. You can, however, specify only uppercase letters and numbers.

-QD message-ID

Modifies the message ID you want to assign to the message to be sent.

You can specify a character string of 1 to 24 bytes. You can, however, specify only uppercase letters and numbers.

-qE dead-letter-queue-name

Modifies the dead letter queue name.

You can specify a character string of 1 to 48 bytes. Specify the queue name using an MQ character string.

-qH hold-time

Modifies the hold time for the message to be sent.

You can specify a value between 1 and 9,999,999 for the minute.

-QM model-queue-name

Modifies the model queue name.

You can specify a character string of 1 to 48 bytes. Specify the queue name using an MQ character string.

-qd message-data-file-name

Modifies the name of the message data file.

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

-qF message-format-name

Modifies the message format name.

You can specify a character string of 1 to 8 bytes. You can, however, specify only uppercase letters and numbers.

-qM queue-manager-name

Modifies the name of the queue manager used to sent the message.

You can specify a character string of 1 to 48 bytes. Specify the queue manager name using an MQ character string.

-qp connection-queue-management-program-name

Modifies the name of the connection queue management program.

You can specify a character string of 1 to 48 bytes. Specify the program name using an MQ character string.

-qR priority

Modifies the priority of the message to be sent.

You can specify a value between 0 and 9.

-qP permanence

Modifies the permanence of the message to be sent.

You can specify either of the following characters:

y: Permanent

n: Not permanent

-QQ queue-name

Modifies the name of the queue used to send the message.

You can specify a character string of 1 to 48 bytes. Specify the queue name using an MQ character string.

-jt {q|n}

Changes the queuing attribute type.

q: The queuing attribute exists.

n: The queuing attribute does not exist.

MSMQ-sending-job-information-change-options

These options modify definition information for an MSMQ sending job.

-SA application-information

Modifies the application information for the message to be sent.

You can specify a hexadecimal value between 0 and FFFFFFFF.

-SH maintenance-duration

Modifies the hold time for the message to be sent.

You can specify the following values:

-1: INFINITE

n: 0 to 2,147,483,647 (seconds)

-sJ journal-queue-storage-specification-for-message

Modifies the specification for storing the sent message into the journal queue.

You can specify either of the following characters:

y: Stores the message into the journal queue.

n: Does not store the message into the journal queue.

-SM message-label

Modifies the message label for the message to be sent.

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

-sL sending-time-out-limit

Modifies the time-out limit for transmitting the message to be sent.

You can specify the following values:

-2: LONG_LIVED

-1: INFINITE

n: 0 to 2,147,483,647 (seconds)

-sM sending-mode

Modifies the sending mode for the message to be sent.

You can specify either of the following characters:

h: Transmits the message in the high-speed mode.

r: Transmits the message in the restorable mode.

-sP priority

Modifies the priority of the message to be sent.

You can specify a value between 0 and 7.

-sl queue-label-name

Modifies the queue label name for the message destination.

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

-SQ queue-path-name

Modifies the queue path name for the message destination.

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

-SR correlation-ID

Modifies the correlation ID of the message to be sent.

You can specify a character string of 1 to 20 bytes. You can, however, specify only uppercase letters and numbers.

-sF text-file-name

Modifies the text file name for the message to be sent.

You can specify a character string of 1 to 259 bytes. Use a full path to specify the file name.

-sT text-type

Modifies the type of the text of the message to be sent.

You can specify a hexadecimal value between 0 and FFFFFFFF.

-sU dead-letter-queue-storage-specification-for-message

Modifies the specification for storing the sent message into the dead letter queue.

You can specify either of the following characters:

y: Stores the message into the dead letter queue.

n: Does not store the message into the dead letter queue.

-jt {q|n}

Changes the queuing attribute type.

q: The queuing attribute exists.

n: The queuing attribute does not exist.

HP-NNM-status-report-job-information-change-options

These options modify definition information for an OpenView status report job.

-pf platform-type

Modifies the platform type.

You can specify either of the following characters:

u: Operates in a UNIX environment.

p: Operates in a Windows environment.

-CI message-additional-information-to-post-to-HP NNM

Modifies the additional information for the message you want to post to HP NNM.

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

-CC status-to-post-to-HP NNM

Modifies the status you want to post to HP NNM.

You can specify on of the following character strings:

un: Unknown

no: Normal

wa: Warning

mi: Minor

ma: Major

cr: Critical

re: Restricted

te: Testing

di: Disabled

-jt {q|n}

Changes the queuing attribute type.

q: The queuing attribute exists.

n: The queuing attribute does not exist.

local-power-control-job-information-change-options

These options modify definition information for a local power control job.

-pf platform-type

Modifies the platform type.

You can specify either of the following characters:

u: Operates in a UNIX environment.

p: Operates in a Windows environment.

-PT power-control-type

Modifies the power control type.

You can specify one of the following characters:

f: Turns off the power.

r: Shuts down and then restarts the system.

s: Shuts down the system.

-Pf shutdown-type

Modifies the shutdown type.

You can specify one of the following characters:

m: Performs monitoring termination.

r: Performs restrictive termination.

f: Performs forced termination.

p: Performs planned termination.

-jt {q|n}

Changes the queuing attribute type.

q: The queuing attribute exists.

n: The queuing attribute does not exist.

remote-power-control-job-information-change-options

These options modify definition information for a remote power control job.

-pf platform-type

Modifies the platform type.

You can specify either of the following characters:

u: Operates in a UNIX environment.

p: Operates in a Windows environment.

-PH power-control-target-host-name

Modifies the name of the JP1/Power Monitor agent host to which you want to apply power control.

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

-PF power-control-type

Modifies the power control type for the JP1/Power Monitor agent host.

You can specify one of the following characters:

o: Turns on the power.

m: Performs monitoring termination.

r: Performs restrictive termination.

f: Performs forced termination.

p: Performs planned termination.

s: Performs forced stop.

-PN next-power-on-time-setting

Modifies the setting of the next power-on time for the JP1/Power Monitor agent host.

You can specify one of the following characters or values:

n: Does not specify a next power-on time.

a: Enables the next power-on time set for the JP1/Power Monitor agent host.

c:[MM/DD.]hh:mm Specify the time in the c:[MM/DD.]hh:mm format. You can specify the following values:
MM: 1 to 12 (month)
DD: 1 to 31 (day)
hh: 0 to 23 (hour)
mm: 0 to 59 (minute)

-PR restart

Modifies the setting of restart after the shutdown of the JP1/Power Monitor agent host.

You can specify either of the following characters:

y: Restarts the host.

n: Does not restart the host.

-PW power-off-termination-wait

Modifies the setting of whether to wait for the JP1/Power Monitor agent host to completely turn off before terminating the remote power control job.

You can specify either of the following characters:

y: Waits for shutdown.

n: Does not wait for shutdown.

-PP platform-type-of-power-control-target-host

Modifies the platform type for the host on which you will execute the remote power control job.

You can specify either of the following characters:

u: Operates in a UNIX environment.

p: Operates in a Windows environment.

-jt {q|n}

Changes the queuing attribute type.

q: The queuing attribute exists.

n: The queuing attribute does not exist.

Notes

You can modify the definition of a job only if you have the update privilege assigned when you defined the job or modified its attributes.

We recommend that you not execute this command during the execution of a jobnet. (This command terminates abnormally if some other process is using the target job. You cannot use JP1/AJS3 - View to manipulate or update a job while you are modifying the definition of the job with this command. You cannot execute a job while you are manipulating it.)

To modify the definition of a job in a registered jobnet, we recommend that you first cancel the registration of the jobnet. Use the ajsleave command when canceling the registration of jobnets.

If you specify any invalid option for the unit, this command will terminate abnormally.

If the jobnet for which you modify the definition is a release target jobnet (root jobnet for which release entry is made), the job definitions in the jobnet in Being applied status are modified.

Return values

0 Normal end

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

Additional information

To leave information undefined (default) for one of the following options, specify "" for the option.

Job common information change option

UNIX/PC/QUEUE job information change option

Judgment job information change option

JP1 event reception monitoring job information change option

File monitoring job information change option

Email reception monitoring job information change option

Message queue reception monitoring job information change option

MSMQ reception monitoring job information change option

Log file monitoring job information change option

Windows event log monitoring job information change option

Execution interval control job information change option

JP1 event sending job information change option

Email sending job information change option

Message queue sending job information change option

MSMQ sending job information change option

OpenView status report job information change option

Local power control job information change option

Remote power control job information change option

Example

The following command changes the standard output file for job net1/job1 to /dev/null:
 
ajschgjob  -so /dev/null net1/job1

[Contents][Back][Next]

[Trademarks]

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