Job Information

Specify the location where the JCL for the job to be started is registered when you start a job before the Send processing, after the Send processing, or after the Receive processing.

There are two ways to register the information.

(1) Field List

'Optional' in the chart below refers to whether or not the field is optional for registration on the HULFT Management Console. Optional parameters for batch registration may differ from optional fields on the HULFT Management Console.

For details on optional parameters for batch registration, refer to Registration and modification of management information.

Table 2.6 List of Job Information Fields

Field Name

When Defaulted

Setting

Optional

Remarks

Screen

File

Job ID

JOB

 

Alphanumeric characters

-

Within 50 bytes

JCL Library

DSNAME

 

Alphanumeric characters

-

Within 44 bytes

Member Names

MEMBER DEF
to DEFEND

 

Alphanumeric characters

-

Within 8 bytes

JOB RC Criterion

JOB-RC

0

From 0 to 4095

✓

 

Comment

COMMENT

 

Alphanumeric characters, half-width Katakana

✓

Within 60 bytes

✓

:

Optional

-

:

Mandatory

(2) Specification of each field

The following explains the fields specified in the Job Information. Strings within brackets () are the tags of parameter names to be defined in a definition card for the Management Information Batch Registration program (XRSYSINF).

Job ID (JOB)

This field specifies the ID to identify the job to be executed.

This Job ID is linked with the Job ID in the Send Management Information and in the Receive Management Information.

JCL Library (DSNAME)

This field specifies the name of the JCL library that stores the Member Names (MEMBER DEF to DEFEND).

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

Member Names (MEMBER DEF to DEFEND)

This field specifies the job name of the job to be executed.

JOB RC Criterion (JOB-RC)

This field specifies the maximum value of successful return codes of the job to be executed.

When the job specified for the Member Names (MEMBER DEF to DEFEND) is executed, if the return code is equal to or lower than the value set for the JOB RC Criterion (JOB-RC), HULFT regards the job as successful.

Comment (COMMENT)

This field specifies the comment on the startup job.

(3) Points to be noted when specifying

JCL Library

The JCL Library organizations that you can specify are listed below.

  • Partitioned data set (PDS)

  • Partitioned data set extended (PDSE)

The JCL Library you specify must be cataloged.

Do not enclose the name of the JCL Library within single quotations (').

Member Name

The maximum number of member names you can set in the Job Information is 90.

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

Specification of multiple jobs

If you specify multiple member names in the Job Information, the jobs are started in order. The jobs are not started in parallel.

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

Error in Pre-send Job

If the return code of a Pre-send Job is higher than the value that is specified for the JOB RC Criterion (JOB-RC), the Send File ends with an error.

Replacement Message

  • In the following fields, if you specify '&MSG0' to '&MSG5' or '&MSGL0' to '&MSGL1,' the strings are replaced with messages that you specified when you issued the Send File, or with received messages:

    • JCL Library (DSNAME)

    • Member Names (MEMBER DEF to DEFEND)

    = Remarks =

    For the JCL Library (DSNAME) and the Member Names (MEMBER DEF to DEFEND), you cannot specify multiple messages consecutively, nor can you specify a message with a fixed string.

    Incorrect: &MSG0.JCL

    Correct: &MSG0

  • HULFT may not be able to carry out replacement with message correctly and the transfer may fail, depending on the language settings on the remote host.

    For points to be noted on message transmission, refer to Administration Manual.