Remote Job Execution command

Explanation of the parameters

-h hostname

Host name of the host that executes the job (Mandatory)

Specify the host name as an alphanumeric character string within 68 bytes.

-j jobID

Job ID of the job to be executed (Mandatory)

Specify the parameter as an alphanumeric character string within 50 bytes. This job ID must be registered in the Job Information of the remote host.

-o filename

Name of the file to which HULFT outputs the job execution request result (Optional)

Specify the file name as an alphanumeric character string within 128 bytes.

Specify the full path of the file name. If the file name is not specified (if only -o is specified), the results are output to the standard output.

When you omit this parameter, the job execution results are not output. If the connection to the remote host fails, HULFT does not output the results.

-sync

Synchronous execution request (Optional)

The parameter specifies synchronization with the end of a job execution by a remote host.

When you omit this parameter, the synchronization ends when HULFT issues the request.

Specify the -w parameter (Synchronous Transfer Timeout) when you set this parameter.

-w time

Synchronous Transfer Timeout (seconds) (Optional)

This field specifies the interval at which HULFT synchronizes to obtain the processing results in the range of '10' to '259200' when a Synchronous Transfer is specified.

When you omit this parameter, the value that is set for Job Timeout (jobwtimeout) in the System Environment Settings file (hulenv.conf) is applied.

To specify this parameter, you must specify the parameter -sync.

-v8

Specification of full display of the job ID in the execution request results (Optional)

Job execution request results are displayed in an output format that can fully display the job ID even if the job ID exceeds 8 bytes.

When you omit this parameter, HULFT outputs results in the format for HULFT lower than Ver.8, and only the first 8 characters of the job ID are displayed.

Note

There are some points to be noted on the Non Communication Timeout and the Remote Job Timeout when the Synchronous Transfer is specified.

For details, refer to Administration Manual.

<Output example of job execution request result (when '-v8' is not specified)>

JOBID=JOB00001 DATE=2014/12/25 STIME=20:15:22 ETIME=20:20:12 RC=00000-000000000 HOST=HOST01.hulft.co.jp

<Output example of job execution request result (when '-v8' is specified)>

JOBID=00000123456789012345678901234567890123456789012345 
 DATE=2014/12/25 STIME=20:15:22 ETIME=20:20:12 RC=00000-000000000 HOST=HOST01.hulft.co.jp

<Explanation of the message>

JOBID

Job ID (50 bytes)

DATE

Date on which the host started issuance of the request

= Remarks =

The date format varies depending on Date Format (datefmt) that is specified in the System Environment Settings. For details, refer to Administration Manual.

STIME

Time when the host started issuance of the request (hh:mm:ss)

ETIME

Time when the host ended issuance of the request (hh:mm:ss)

RC

Status code (5 bytes) - detail code (9 bytes)

= Remarks =

The values shown below are set to the status code.

• When the platform of the requestee-side host is HULFT for UNIX/Linux

  Detail code in the Observe Log

  0:

  Successful end

  Other than 0:

  Unsuccessful end

  Refer to Error Codes and Messages for the Termination Status upon Unsuccessful Termination of Command.

• When the platform of the requestee-side host is not HULFT for UNIX/Linux

  Refer to Operation Manual of the HULFT on the requestee-side host.

HOST

Host name of the host that requested the remote job execution (68 bytes)