Job Information
This topic explains how to register the startup commands that HULFT executes as the Pre-send Job, the Post-send Job, or the Post-receive Job.
You can view and modify this information on the following screens:
- Register Job Information/Modify Job Information Record screen
- Collecting and Distributing System Management Information screen
You can also import and export this information on the following screen:
- Collecting and Distributing System Management Information screen
| [Note] | For versions lower than HULFT-HUB Server Ver.3.9, if the client is HULFT Ver.8.4 or higher and the Forced Strong Key Mode is set to 'Enabled' in the System Environment Settings, connection with the client is not supported. Therefore, it is not possible to view, update, or newly register the management information for that client. |
List of Fields
1. Job Information
<Table> List of Fields for Job Information
| No. | Field Name | Default Value | Setting Value | Specification | Remarks | Update | Distribute |
|---|---|---|---|---|---|---|---|
| A1 | Job ID | Alphanumeric characters and "_" *1 | Mandatory | Within 50 bytes (starting with an alphabetic character) | ✓ | ✓ | |
| A2 | Job Description | Alphanumeric characters | Mandatory | From 3 to 21 bytes | ✓ | ✓ | |
| A3 | Startup Job | Alphanumeric characters | Mandatory | Within 210 bytes per job | ✓ | ✓ | |
| A4 | Comment | Alphanumeric characters | Optional | Within 60 bytes | ✓ | ✓ |
| *1: | If the Controlling Server is HULFT-HUB Server that is lower than Ver.3.10, you cannot use "_". |
2. Additional information other than Job Information
You can view both the Job Information and the following additional information on each screen where you edit Transfer definitions.
<Table> List of Fields for Additional Information other than Job Information
| No. | Field Name | Default Value | Setting Value | Specification | Remarks |
Update |
Distribute |
|---|---|---|---|---|---|---|---|
| B1 | Alias | Alphanumeric characters | Optional | Within 256 bytes | ✓ | ✓ | |
| B2 | Business Group ID | *1 | Mandatory | ✓ | ✓ | ||
| B3 | Batch Distribution ID | Alphanumeric characters | *2 | - | ✓ |
| *1: | When you configure settings on the screen, select an option from the list that is shown on the screen. |
| *2: | You are allowed only to view this field on the screen. |
| [Legend] | |
| Default Value | Value that is set for the field when you create a new management information record on a screen |
| Specification | Whether the specification is mandatory or optional when you update the management information record on a screen |
| Update | Register Job Information/Modify Job Information Record screen |
| Distribute | Collecting and Distributing System Management Information screen |
| ✓ | Availability of the field |
Explanation of Each Field
The following describes the fields that are configured in the Job Information.
1. Job Information
This field specifies the ID to identify the job to be started.
This Job ID is associated with the Job ID in the Send Management Information and with the Job ID in the Receive Management Information.
This field specifies the job description name.
Use the format 'Library Name/Job Description Name.'
This field specifies the CL commands.
Specify the CL commands to start up jobs. You can register a maximum of five jobs for a single job ID.
This field specifies the comment for the startup job.
| [Note] | If you enter double-byte codes on a screen in HULFT-HUB Manager, shift codes may be added to the double-byte codes when the information is registered on the client side. If the data exceeds 60 bytes when shift codes are added, HULFT will cut the data of the 61st byte and after. |
| [Remarks] | You can enter lowercase alphabetic characters. |
2. Additional information other than Job Information
This additional information is displayed together with the Job Information on each screen where you edit the Job Information. You can view and modify this information on screens in HULFT-HUB Manager.
This field specifies the alias for the job.
It is recommended that you assign a unique name in the Job Information so that each job ID that is displayed on screens in HULFT-HUB Manager can be easily identified.
This field specifies the Business Group ID that uses this Job Information.
This field shows the Batch Distribution Information ID with which the Job Information is registered as distribution data.
| [Remarks] | You can view this field on the Collecting and Distributing System Management Information screen (cannot be modified). |
Points to be Noted When Configuring Settings
1. Specification of multiple jobs
After you submit (SBMJOB) the specified job name as a program in HULFT, execute the REXX procedure. If you specify multiple jobs, HULFT executes the jobs in order. HULFT does not execute the jobs in parallel.
2. Error in Pre-send Job
If the Pre-send Job fails, an error occurs and the Send File ends.
3. Unsuccessful termination of job
If the Post-send Job or the Post-receive Job fails and a value that exceeds the Job Interrupt Severity in the System Environment Settings is detected, HULFT will execute no further jobs. Note that if jobs are anything other than CL commands, the jobs may not be started.
4. Use of single quotation marks
When using single quotation marks (') in a job name, use them in pairs ('').
5. Replacement message
You can replace variables with received messages by specifying the variables from '&MSG0' to '&MSG5' or from '&MSGL0' to '&MSGL1' in the parameters for the job (Message Transmission function). You cannot apply replacement with message to the job name.
| [Note] | |
| - | For details about the Message Transmission function, refer to Administration Manual for the client. |
| - | Depending on the language settings on the remote host, replacement with message may not be carried out correctly and transfer may fail. For details, refer to Administration Manual. |
6. Messages during job execution
If the specification for the Post-send Job or the Post-receive Job is not correct, when the job is executed, HULFT places a message in the output queue (OUTQ) for when the Send system or the Receive system starts up. Check if the relevant output queue is connected to a printer or other device. In addition, delete the messages in the output queue on a regular basis. For more information about the output queue, refer to the IBM i manuals.
7. Relationship between job description and job execution
When HULFT submits (SBMJOB) internally the specified job name as a subsequent job of HULFT, it uses the specified job description in the Job Information. If '*JOBD' is specified as the default value for the parameters of the submit (SBMJOB) command of IBM i, the job description that is specified in the Job Information is used.
However, the execution environments for the jobs (parent) that created the following jobs are also used when executing these jobs. Therefore, HULFT ignores the job description that is specified in the Job Information.
| - Pre-send Job |
| - Post-receive Successful Job (when 'Successful Job Completion' is selected for the Notification in the Receive Management Information) |
| - Job that is executed due to a remote job execution request |