List of Job Information fields
The Job Information stores the information about the commands that you run as a job before the Send processing, after the Send processing, or after the Receive processing. A maximum of five jobs can be registered per Job ID. For the registration method, refer to Using the Job Information.
(1) Field List
|
Field Name |
Default Value |
Setting Value |
Optional |
Remarks |
|---|---|---|---|---|
|
Job ID |
|
Alphanumeric characters |
- |
Within 50 bytes starting with an alphabetic character |
|
Comment |
|
Characters |
✓ |
Within 60 bytes (*1) |
|
Job Description |
|
Alphanumeric characters |
- |
3–21 bytes |
|
Startup Job |
|
Alphanumeric characters |
- |
Within 210 bytes per job |
|
✓ |
: |
Optional |
|
- |
: |
Mandatory |
|
*1 |
: |
On the HULFT Manager Management Console, you can enter a string of up to 60 characters. When the destination host is HULFT Ver.8.1 or higher, the size of the string that you entered will be checked based on the code set that is set in HULFT at the connection destination. When HULFT checks and confirms that the size of the string meets the condition that is given in the remarks, the characters that you entered will be saved in HULFT. |
(2) Explanation of each field
This section explains the fields to be specified in the Job Information.
- Job ID
-
ID to identify the user job that is to be started
This job ID is associated with the job ID in the Send Management Information and in the Receive Management Information.
- Comment
-
Comment for the user job to be started
- Job Description
-
Job description name
Specify the name in the format of 'library name/job description name.'
- Startup Job
-
CL command
Specify the CL command to run.
(3) Points to be noted when configuring settings
Specification of multiple jobs
After the specified Job Name is executed as HULFT program, execute the REXX procedure. When a number of jobs are specified, the jobs are executed in a sequence. Jobs are not executed in parallel.
Pre-send Job Error
If the Pre-send Job ends with an error, the Send File is terminated with an error.
Abnormal end of job a job
When there is an error in the Post-send Job or the Post-receive Job, if a value greater than Job Interrupt Severity registered in the System Environment Settings file (HULFT.PARMLIB(HULPRM)) is detected, the subsequent jobs are not executed. When the job is not a CL command, the job may not be able to be started.
Single Quotation Mode
To use single quotation (') in a job name, specify with two continuous single quotations ('').
Replacement Message
-
Specify '&MSG0' to '&MSG5' or '&MSGL0' to '&MSGL1' in the job parameters to replace the variables with received messages. (This cannot be specified for Job Name.)
-
The message is converted with the type of the code set that is specified for HULFT Character Set (HULCHARSET) in the System Environment Settings.
-
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 destination host.
For points to be noted on message transmission, refer to IBMi Administration Manual.
Message at job execution
When the specification of Post-send Job or Post-receive Job startup is incorrect, the message will be output to the output queue (OUTQ) at startup of the Send system or the Receive system during job execution. Check that the output queue is not connected to a printer. Also, delete the messages from the output queue regularly.
For details of output queue, refer to the relevant manual of IBM i.
Jobs that ignore Job Description in Job Information
For the following jobs, the Job Description specified in the Job Information is ignored.
|
Job |
Execution Environment Used |
|---|---|
|
Pre-send Job |
Execution environment of the user issued UTLSEND |
|
Post-receive Successful Job (When specifying 'Successful Job Completion' for Notification in the Receive Management Information) |
Execution environment for Post-receive Job |
|
Job that will be executed as a result of Remote Job Execution Request |
Execution environment for Observe Job |
Relation between Job Description and job execution
The Job Description that is specified in the Job Information is used when HULFT internally executes the specified Job Name as the Post-send Job or the Post-receive Job.
The relationship between the default values for each parameter in the IBM i submit command (SBMJOB) and the values that are actually used is shown below.
|
Default Value |
Actual Value |
|---|---|
|
'*JOBD' |
Value for Job Description specified in the Job Information |
|
Other than '*JOBD' |
Value specified as default value |
Comment
Even if full-width characters that are registered in Comment can be displayed on the HULFT Manager Management Console, the characters may not be displayed correctly on the HULFT Management Console for HULFT8 for IBMi.