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

4.2.24 UNIX/PC custom job definition

This paragraph explains how to specify a UNIX/PC custom job definition.

The following gives the format of, and the parameters for a UNIX/PC custom job definition.
Format
[cty="custom-job-class-name";]
[te="command-text";]
[sc="script-file-name";]
[prm="parameter";]
[env="environment-variable";]
[so="standard-output-file-name";]
[se="standard-error-output-file-name";]
[etm=n;]
[fd=time-required-for-execution;]
[pr=n;]
[ex="job-execution-agent-host-name";]
[un="target-user-name";]
[jd={nm|ab|cod|mdf|exf};]
[wth=n;]
[tho=n;]
[jdf="end-judgment-file-name";]
[ha={y|n};]
[eu={ent|def};]
[wkp="work-path-name";]
[ev="environmental-variable-file-name";]
[si="standard-input-file-name";]
[soa={new|add};]
[sea={new|add};]
[ts1="transfer-source-file-name-1";]
[td1="transfer-destination-file-name-1";]
[top1={sav|del};]
[ts2="transfer-source-file-name-2";]
[td2="transfer-destination-file-name-2";]
[top2={sav|del};]
[ts3="transfer-source-file-name-3";]
[td3="transfer-destination-file-name-3";]
[top3={sav|del};]
[ts4="transfer-source-file-name-4";]
[td4="transfer-destination-file-name-4";]
[top4={sav|del};]
 
Parameters

cty="custom-job-class-name";

Define a custom job class name.

You can set a character string of 1 to 16 bytes.

If you want to use a double quotation mark (") or a number sign (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

The following gives the class names to be defined to use the custom jobs supported in the standard JP1/AJS3 configuration.

Linked program name Class name

JP1/FTP JP1FTP

JP1/AJS3 for Enterprise Applications JP1AMR3

JP1/AJS3 for Enterprise Applications JP1AMR3BW

JP1/AJS2 for Oracle E-Business Suite JP1AMOAP

te="command-text";

Define command text.

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

If you want to use a double quotation mark (") or a number sign (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

sc="script-file-name";

For the Unix job, define a full-path script file name. For the PC job, define a full-path executable file name.

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

If you want to use a double quotation mark (") or a number sign (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

prm="parameter";

Define a parameter for the target file.

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

If you want to use a double quotation mark (") or a number sign (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

env="environment-variable";

Define an environment variable.

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

If you want to use a double quotation mark (") or a number sign (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

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

so="standard-output-file-name";

Define a full-path standard output file name.

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

If you want to use a double quotation mark (") or a number sign (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

se="standard-error-output-file-name";

Define a full-path standard error output file name.

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

If you want to use a double quotation mark (") or a number sign (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

etm=n;

Define the time-out period using the relative minutes from the start time.

You can set 1 to 1,440 minutes.

fd=time-required-for-execution;

Define the time-required-for-execution within which the job is expected to be terminated.

You can specify a decimal value between 1 and 1,440 (minutes).

pr=n;

Define the priority of job execution.

You can set 1 to 5. The lowest priority of execution is 1, while the highest priority is 5. The default depends on the definition of upper-level jobnet. The system assumes a value of 1 as the priority of job execution if this parameter is not specified and if the pr or ni parameter is not specified for any of the upper-level units (including the highest).

ex="job-execution-agent-host-name";

Define the name of the JP1/AJS3 - Agent host to execute a job.

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

un="execution-user-name";

To use the JP1/AJS3 - Agent host to execute a job, define the user name of the user responsible for job execution.

You can set a character string of 1 to 63 bytes. The user name cannot contain any space characters.

If you want to use a double quotation mark (") or a number sign (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

jd={nm|ab|cod|mdf|exf};

Define the type of end judgment. The default is cod.

nm: Always assumes a normal end.

ab: Always assumes an abnormal end.

cod: Normal end if the end code is below a specified value.

mdf: Normal end if the file is refreshed.

exf: Normal end if a file is created.

wth=n;

Define the threshold for the end with warning.

You can set 0 to 2,147, 483, 647.

tho=n;

Define the threshold for the abnormal end.

You can set 0 to 2,147, 483, 647. The default is 0.

jdf="end-judgment-file-name";

Define a full-path end judgment file name.

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

If you want to use a double quotation mark (") or a number sign (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

ha={y|n};

Define whether to suspend job execution. The default is n.

y: Suspends jobnet execution.

n: Does not suspend jobnet execution.

eu={ent|def};

Define the JP1 user who executes the job. The default is ent.

ent: The JP1 user who registered the jobnet executes the job.

def: The JP1 user who owns the job executes the job.

wkp="work-path-name";

Define the work path name using a full path name.

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

For a work path name including a double quotation mark (") or a number sign (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

ev="environmental-variable-file-name";

Define the environmental variable file name for the agent host.

You can set a character string of 1 to 511 bytes. You can use either an absolute path or a relative path to specify the file name. If you specify a relative path, the system assumes it to be a relative path from the work path for job execution.

For a file name including a double quotation mark (") or a number sign (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

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

si="standard-input-file-name";

Define the name of a standard input file on the agent host executing the job.

You can set a character string of 1 to 511 bytes. You can use either an absolute path or a relative path to specify the file name. If you specify a relative path, the system assumes it to be a relative path from the work path for job execution.

For a file name including a double quotation mark (") or a number sign (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

soa={new|add};

Define the append option for a standard output file name. The default is new. This parameter is invalid if the so parameter does not specify the standard output file name.

This cannot be specified in PC custom jobs.

new: Creates a new file.

add: Adds information to an existing file.

sea={new|add};

Define the append option for a standard error output file name. The default is new. This parameter is invalid if the se parameter does not specify the standard error output file name.

This cannot be specified in PC custom jobs.

new: Creates a new file.

add: Adds information to an existing file.

ts1="transfer-source-file-name-1";

Define the name of a transfer source file using a full path name.

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

For a file name including a double quotation mark (") or a number sign (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

td1="transfer-destination-file-name-1";

Define the name of a transfer destination file to be transferred to the agent host.

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

The default is the $JP1AJS2_JPQTEMPxx$ variable, where the xx part means the transfer file's number ranging from 01 to 04.

With this variable specified in the sc or prm parameter, you can execute the job without having to be aware of the transfer destination file name.

For a file name including a double quotation mark (") or a number sign (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

top1={sav|del};

Define the option to automatically delete the transfer destination file.

sav: Saves the file.

del: Deletes the file.

If you specify the transfer source file name and the transfer destination file name without specifying this parameter, the system assumes sav.

If you specify the transfer source file name without specifying this parameter, the system assumes del.

This cannot be specified in PC custom jobs.

ts2="transfer-source-file-name-2";

Define the name of a transfer source file using a full path name.

1 to 511 bytes of characters can be specified.

For a file name including a double quotation mark (") or a cast character (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

td2="transfer-destination-file-name-2";

Define the name of a transfer destination file to be transferred to the agent host.

1 to 511 bytes of characters can be specified.

The default is the $JP1AJS2_JPQTEMPxx$ variable, where the xx part means the transfer file's number ranging from 01 to 04.

With this variable specified in the sc or prm parameter, you can execute the job without having to be aware of the transfer destination file name.

For a file name including a double quotation mark (") or a number sign (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

top2={sav|del};

Define the option to automatically delete the transfer destination file.

sav: Saves the file.

del: Deletes the file.

If you specify the transfer source file name and the transfer destination file name without specifying this parameter, the system assumes sav.

If you specify a transfer source file name without specifying a transfer destination file name and this parameter, this parameter defaults to del.

This cannot be specified in PC custom jobs.

ts3="transfer-source-file-name-3";

Define the name of a transfer source file using a full path name.

1 to 511 bytes of characters can be specified.

For a file name including a double quotation mark (") or a number sign (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

td3="transfer-destination-file-name-3";

Define the name of a transfer destination file to be transferred to the agent host.

1 to 511 bytes of characters can be specified.

The default is the $JP1AJS2_JPQTEMPxx$ variable, where the xx part means the transfer file's number ranging from 01 to 04.

With this variable specified in the sc or prm parameter, you can execute the job without having to be aware of the transfer destination file name.

For a file name including a double quotation mark (") or a cast character (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

top3={sav|del};

Define the option to automatically delete the transfer destination file.

sav: Saves the file.

del: Deletes the file.

If you specify the transfer source file name and the transfer destination file name without specifying this parameter, the system assumes sav.

If you specify a transfer source file name without specifying a transfer destination file name and this parameter, this parameter defaults to del.

This cannot be specified in PC custom jobs.

ts4="transfer-source-file-name-4";

Define the name of a transfer source file using a full path name.

1 to 511 bytes of characters can be specified.

For a file name including a double quotation mark (") or a cast character (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

td4="transfer-destination-file-name-4";

Define the name of a transfer destination file to be transferred to the agent host.

1 to 511 bytes of characters can be specified.

The default is the $JP1AJS2_JPQTEMPxx$ variable, where the xx part means the transfer file's number ranging from 01 to 04.

With this variable specified in the sc or prm parameter, you can execute the job without having to be aware of the transfer destination file name.

For a file name including a double quotation mark (") or a cast character (#), prefix the character by #. That is, use #" instead of " and use ## instead of #.

This cannot be specified in PC custom jobs.

top4={sav|del};

Define the option to automatically delete the transfer destination file.

sav: Saves the file.

del: Deletes the file.

If you specify the transfer source file name and the transfer destination file name without specifying this parameter, the system assumes sav.

If you specify a transfer source file name without specifying a transfer destination file name and this parameter, this parameter defaults to del.

This cannot be specified in PC custom jobs.

Linked program name	Class name
JP1/FTP	JP1FTP
JP1/AJS3 for Enterprise Applications	JP1AMR3
JP1/AJS3 for Enterprise Applications	JP1AMR3BW
JP1/AJS2 for Oracle E-Business Suite	JP1AMOAP

[Contents][Back][Next]

[Trademarks]