Receive Status Display command

To display the status of Receive job activity, use the WRKACTJOB (work with active jobs) command provided by IBM i. For more details, refer to a relevant manual of IBM i.

To confirm the Receive Job processing status details, execute the Receive Status Display command. The Receive Job log will be output to the standard output.

Program interface

CALL Library name/UTLRDISP PARM(['LIB=Library name'] 
   ['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.

G

Control of error messages that the Receive Status Display command outputs (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages that the Receive Status Display 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 Receive Status Display 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.

Command interface

UTLRDISP LIBRARY( ) MSG( ) FILE( ) MBR( )

Explanation of parameters

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.

Output example

HOSTNAME:AS400             
FILEID  :FILEID02          
RECORDS :                    100000 
BYTE    :                   5000000 
FILENAME: HULDLIB/HUL004(RCVDATA) 
TRID    : 6200795E66E37F0FED333341C7BA3C96410000000000000000000000000000000000

Explanation of Each Field

HOSTNAME

Name of a host on the sending side

FILEID

File ID of which receiving is in progress

For an instant transfer, "_INSTANT_TRANSFER_" is displayed.

RECORDS

Number of records that have been received until now

BYTE

Size of the data that has been received until now

FILENAME

Receive File Name

TRID

Transfer ID for receiving-side transferring