Unsent Status Queue Modification command

You can modify the status of the records in the Send Queue.

Program interface

CALL Library name/UTLSCHANGE PARM(['LIB=Library name'] 'F=fileid' 
   'H=hostname' ['P=priority'] ['I=time'] ['BL=blocklen'] ['BC=block'] 
   ['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.

F=fileid

Target File ID in the Send Queue that you want to modify the set value (Mandatory)

Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.

H=hostname

Name of the host on the receiving side in the Send Queue that you want to modify the set value (Mandatory)

Specify this parameter as an alphanumeric character string of 68 bytes or less.

P=priority

Priority (Optional)

Specify a numeric value in a range of "1" to "256".

Smaller number indicates higher priority.

I=time

Transfer Interval (msec.) (Optional)

Specify a numeric value in a range of "0" to "32767".

BL=blocklen

Transfer Block Length (Optional)

Specify a numeric value of "0" or in the range from "128" to "65520". However, Transfer Block Length multiplied by Transfer Block Count cannot exceed "65520".

BC=block

Transfer Block Count (Optional)

Specify a numeric value in the range from "0" to "99". However, Transfer Block Length multiplied by Transfer Block Count cannot exceed "65520".

G

Control of error messages that the Unsent Status Queue Modification command outputs (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Unsent Status Queue Modification command outputs (Optional)

Specify this parameter in the format of Library name/File name(Member name).

When omitted, error 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 Unsent Status Queue Modification command 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.

Note

  • When multiple records exist with the same host name or file ID in the Send Queue, only the first record found by searching the host name or file ID from the top of the queue is updated.

  • You cannot omit parameters of "P=", "I=", "BL=", and "BC=" at the same time. You must specify at least one of them.

  • HULFT applies "0" to the set value only when you specify "0" for both "BL=" parameter and "BC=" parameter.

  • Setting "0" to either "BL=" parameter or "BC=" parameter causes an error.

Command interface

UTLSCHANGE FILEID( ) HOSTNAME( ) PRIORITY( ) TIME( ) BLOCKLEN( ) BLOCK( ) 
   LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

FILEID

Target File ID in the Send Queue that you want to modify the set value (Mandatory)

Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.

HOSTNAME

Name of the host on the receiving side in the Send Queue that you want to modify the set value (Mandatory)

Specify this parameter as an alphanumeric character string of 68 bytes or less.

PRIORITY

Priority (*SAME by default)

Specify a numeric value in a range of "00001" to "00256".

Smaller number indicates higher priority.

TIME

Transfer Interval (msec.) (*SAME by default)

Specify a numeric value in a range of "00000" to "32767".

BLOCKLEN

Transfer Block Length (*SAME by default)

Specify a numeric value of "00000" or in the range from "00128" to "65520". However, Transfer Block Length multiplied by Transfer Block Count cannot exceed "65520".

BLOCK

Transfer Block Count (*SAME by default)

Specify a numeric value in the range from "00001" to "00099". However, Transfer Block Length multiplied by Transfer Block Count cannot exceed "65520".

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.