List of Job Information fields

Specify the location where the JCL of the job to be started up before sending, after sending, or after receiving is registered. For the registration method, refer to Using the Job Information.

(1) Field List

Table 4.28 List of Job Information Fields

Field Name

Default Value

Setting Value

Optional

Remarks

Job ID

 

Alphanumeric characters

-

Within 50 bytes

Comment

 

Alphanumeric characters, half-width kana

Within 60 bytes

JCL Library

 

Alphanumeric characters

-

Within 44 bytes (*1)

JOB RC Criterion

0 (*2)

0–4095 (*3)

 

Startup Job

 

Alphanumeric characters

-

Within 8 bytes

:

Optional

-

:

Mandatory

*1

:

When connecting to HULFT for XSP, specify a character string within 26 bytes.

*2

:

When connecting to HULFT for XSP, '10' is applied to the default value.

*3

:

When connecting to HULFT for XSP, a range of '10' to '99' is applied to the setting value.

(2) Explanation of each field

This section explains the fields to be specified in the Job Information.

Job ID

ID that identifies the job to be started

This job ID is associated with the job IDs in the Send Management Information and the Receive Management Information.

Comment

Comment for the Startup Job

JCL Library

Name of JCL library in which member names are stored

Specify the name according to the JCL library naming conventions for Mainframe.

JOB RC Criterion

Maximum value for successful return code for the job to be started

When the job is executed, if the return code is equal to or lower than the value set for JOB RC Criterion, HULFT regards the job as successful.

Startup Job

Member name of the job to be started

(3) Points to be noted when configuring settings

JCL Library

JCL Library organizations you can specify are shown below.

  • Partitioned data set (PDS)

  • Partitioned data set extended (PDSE)

The set JCL Library must be cataloged.

Do not enclose the JCL library within single quotations (').

Member Name

Maximum number of member names that can be specified in the Job Information is 90.

Do not enclose member names within single quotations (').

Specification of multiple jobs

When multiple member names are specified in the Job Information, then the jobs are started in the specified order. Jobs are not started concurrently.

If the return code of a job is higher than the value that is specified for JOB RC Criterion, any subsequent jobs are not started.

Pre-send Job Error

If the return code for a Pre-send Job exceeds the value specified for JOB RC Criterion, the Send File outputs an error and is terminated.

Replacement Message

By specifying '&MSG0' to '&MSG5' or '&MSGL0' to '&MSGL1' in the following fields, field values are replaced with the messages that are specified at the time of the Send File or with received messages:

  • JCL Library

  • Startup Job

= Remarks =

You cannot describe two or more messages in JCL Library or in the Startup Job, nor incorporate a message with fixed value to use.

(Incorrect) &MSG0.JCL

(Correct) &MSG0

HULFT may not be able to replace the variables with the messages correctly and the transfer may fail, depending on the language settings on the host on the sending side.

For points to be noted on message transmission, refer to Administration Manual for the destination host.