[Content revised from the 3rd edition]
|
Date of Revision |
Description |
|---|---|
|
December 5, 2023 |
|
Terminating Send system
To end the Send Acknowledge job, type the following command in a terminal.
(1) Terminating the Send Acknowledge job
Program interface
CALL Library name/UTLKILLSND [PARM(['LIB=Library name']
['TERM'] ['G'] ['OUTPUT=filename'] ['EXIT' CL variable name])]
Explanation of parameters
- LIB=Library name
-
Library name in which HULFT is installed ("HULFT" by default)
Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.
- TERM
-
Wait during end-of-job processing (Optional)
When the Send job is in progress, HULFT waits until the completion of the Send processing, and it then ends the Send Acknowledge job.
- G
-
Control of error messages that the Send system outputs (Optional)
When omitted, the error messages are suppressed.
- OUTPUT=filename
-
Destination of the error messages that the Send system outputs (Optional)
Specify this parameter in the format of Library name/File name(Member name).
When omitted, messages are not output.
The number of log records that a log file can retain is unlimited.
- EXIT CL variable name
-
Specifies to receive the error code output by the Send system and specifies the CL variable name to set the error code value (Optional)
The CL variable name must immediately follow the EXIT tag.
HULFT sets an error code to the CL variable only if the command ends unsuccessfully.
When omitted, an error code is not set.
-
If the TERM parameter is not specified, the Send Acknowledge job cannot be ended when there is a job that has already started sending.
-
When the end processing of the Send Acknowledge job is on hold according to the specification of the TERM parameter, HULFT can accept only particular commands, namely, the Send Status Display command (UTLSDISP), the Unsent Status Queue Modification command (UTLSCHANGE), and the Send Cancel command (UTLSCAN).
End processing of the Send Acknowledge job is executed asynchronously.
Therefore, to check if the job has ended, use the WRKACTJOB (Work with Active Jobs) command of the OS or other methods.
Command interface
UTLKILLSND TERM( ) LIBRARY( ) MSG( ) FILE( ) MBR( )
Explanation of parameters
- TERM
-
Wait during end-of-job processing ("*NO" by default)
- *NO :
-
Give an error if the Send processing is in progress.
- *YES :
-
Wait until the completion of the Send processing, then end the Send Acknowledge job.
- LIBRARY
-
Library name in which HULFT is installed ("HULFT" by default)
Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.
- MSG
-
Control of error messages ("*YES" by default)
- *NO :
-
Suppress error messages.
- *YES :
-
Show error messages.
- FILE
-
Name of the library and the file to which error messages are output (Optional)
Specify this parameter in the format of Library name/File name.
Specify these names as an alphanumeric character string of 10 bytes or less starting with an alphabet, respectively.
When omitted, error messages are not output. The number of log records that a log file can retain is unlimited.
- MBR
-
Member name of the file to which error messages are output ("*FILE" by default)
Specify this parameter as an alphanumeric character string of 10 bytes or less starting with an alphabet.
-
If the TERM parameter is omitted or "*NO" is specified, the Send Acknowledge job cannot be ended when there is a job that has already started sending.
-
When the end processing of the Send Acknowledge job is on hold as a result of specifying "*YES" for the TERM parameter, HULFT can accept only particular commands, namely, the Send Status Display command (UTLSDISP), the Unsent Status Queue Modification command (UTLSCHANGE), and the Send Cancel command (UTLSCAN).
End processing of the Send Acknowledge job is executed asynchronously.
Therefore, to check if the job has ended, use the WRKACTJOB (Work with Active Jobs) command of the OS or other methods.