Send and Receive Log List command
Send Log and Receive Log lists can be displayed.
Program interface
CALL library name/UTLLIST PARM(['LIB=library name'] '{S|R}'
['{C=filename|V5=filename|V8=filename|V84=filename}'] ['F=fileid'] ['H=hostname']
['FROM=DATE1'] ['TO=DATE2'] ['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.
- S|R
-
Types of log to be displayed in a list (Mandatory)
- S :
-
Send Log
- R :
-
Receive Log
- C=filename|V5=filename|V8=filename|V84=filename
-
Output format of list (Optional)
Specify this parameter in the format of Library name/File name(Member name).
When you specify "C=", the log is output to the specified file in common format of HULFT V4.
When you specify "V5=", the log is output to the specified file in the common format of HULFT V5.
When you specify "V8=", the log is output to the specified file in the common format of HULFT V8.
When you specify "V84=", the log is output to the specified file in the following format:
- For Ver.8.4 and Ver.8.5:
-
Common format of HULFT V84
- For Ver.10:
-
Common format of HULFT V10
When omitted, standard output is displayed.
For the details on the common formats of HULFT V4, HULFT V5, HULFT V8, and HULFT V8.4, refer to Format of the list output.
- F=fileid
-
Target File ID to be displayed in a list (Optional)
Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.
For an instant transfer, specify "_INSTANT_TRANSFER_".
When omitted, all file IDs are targeted by this command.
- H=hostname
-
Target host name to be displayed in a list (Optional)
Specify this parameter as an alphanumeric character string of 68 bytes or less.
When omitted, all the host names become the targets of this command.
- FROM=DATE1 TO=DATE2
-
Target date to be displayed in a list (Optional)
Specify this parameter in numbers of 8 bytes in length.
When the "FROM=" is omitted, all the log records on and before the date that you specify for the "TO=" become the target of this command.
When the "TO=" is omitted, all the log records on and after the date that you specify for the "FROM=" become the target of this command.
When both are omitted, log records of all dates become target of this command. You must specify the date according to the format specified as Date Format (DATEFMT) in the System Environment Settings, and DATE1 must be earlier than or equal to DATE2.
The log record of the dates you specified for the Date1 and the Date2 are included in the target records to be output in a list.
HULFT searches start dates of sending or receiving.
- G
-
Control of the error messages that the Send and Receive Log List Display command outputs (Optional)
When omitted, HULFT displays error messages.
- OUTPUT=filename
-
Destination of the error messages that the Send and Receive Log List 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 Send and Receive Log List 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.
When one of the parameters "C=", "V5=", "V8=", or "V84=" is specified, the header is not output to the file.
Command interface
UTLLIST LOG( ) FILEID( ) HOSTNAME( ) FROM( ) TO( ) COMMON( ) LFILE( ) LMBR( ) LIBRARY( ) MSG( ) FILE( ) MBR( )
Explanation of parameters
- LOG
-
Types of log to be displayed in a list (Mandatory)
- S :
-
Send Log
- R :
-
Receive Log
- FILEID
-
Target File ID to be displayed in a list (Optional)
Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.
For an instant transfer, specify "_INSTANT_TRANSFER_".
When omitted, all file IDs are targeted by this command.
- HOSTNAME
-
Target host name to be displayed in a list (Optional)
Specify this parameter as an alphanumeric character string of 68 bytes or less.
When omitted, all the host names become the targets of this command.
- FROM TO
-
Target date to be displayed in a list (Optional)
Specify this parameter in numbers of 8 bytes in length.
When the FROM is omitted, all the log records on and before the date that you specify for the TO become the target of this command.
When the TO is omitted, all the log records on and after the date that you specify for the FROM become the target of this command.
When both are omitted, log records of all dates become target of this command. You must specify the date according to the format specified as Date Format (DATEFMT) in the System Environment Settings, and FROM must be earlier than or equal to TO. The log record for the specified date is included in the records output to the list.
HULFT searches the start date of the sending-side or receiving-side transferring.
- COMMON
-
Output format of list ("*NO" by default)
- *NO :
-
Output the list in the format similar to HULFT for OS/400 Ver. 4.1
- *YES :
-
Output the list to the specified file in common format of HULFT V4
- *V5 :
-
Output the list to the specified file in the common format of HULFT V5
- *V8 :
-
Output the list to the specified file in the common format of HULFT V8
- *V84 :
-
Output the list to the specified file in the common format of HULFT V8.4
For the details on the common formats of HULFT V4, HULFT V5, HULFT V8, and HULFT V8.4, refer to Format of the list output.
- LFILE
-
Library name and file name of the file to which a list is 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.
- LMBR
-
Member name of the file to which a list is output ("*FILE" by default)
- 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.
Format of the list output
|
Field Name |
Size |
Start Position |
Display Format |
|---|---|---|---|
|
File ID |
8 |
1 |
Left alignment (Fill with spaces if a value is less than 8 bytes) |
|
|
2 |
9 |
Space |
|
Host Name |
8 |
11 |
Left alignment (Fill with spaces if a value is less than 8 bytes) |
|
|
2 |
19 |
Space |
|
Send and Receive Start Date |
10 |
21 |
YYYY/MM/DD (*1) |
|
|
2 |
31 |
Space |
|
Send and Receive Start Time |
8 |
33 |
HH:MM:SS |
|
|
2 |
41 |
Space |
|
Send and Receive End Time |
8 |
43 |
HH:MM:SS |
|
|
2 |
51 |
Space |
|
Record Count |
10 |
53 |
Right alignment (Insert leading zeros if a value is less than 10 bytes) |
|
|
2 |
63 |
Space |
|
Data Size |
10 |
65 |
Right alignment (Insert leading zeros if a value is less than 10 bytes) |
|
|
2 |
75 |
Space |
|
Status |
13 |
77 |
999999-999999 |
|
|
1 |
90 |
Space |
|
Host Name |
68 |
91 |
Left alignment (Fill with spaces if a value is less than 68 bytes) |
|
*1 |
: |
You must specify the date according to the format specified as Date Format (DATEFMT) in the System Environment Settings. |
|
Field Name |
Size |
Start Position |
Display Format |
|---|---|---|---|
|
File ID |
8 |
1 |
Left alignment (Fill with spaces if a value is less than 8 bytes) |
|
|
2 |
9 |
Space |
|
Host Name |
8 |
11 |
Left alignment (Fill with spaces if a value is less than 8 bytes) |
|
|
2 |
19 |
Space |
|
Send and Receive Start Date |
10 |
21 |
YYYY/MM/DD (*1) |
|
|
2 |
31 |
Space |
|
Send and Receive Start Time |
8 |
33 |
HH:MM:SS |
|
|
2 |
41 |
Space |
|
Send and Receive End Time |
8 |
43 |
HH:MM:SS |
|
|
2 |
51 |
Space |
|
Record Count |
18 |
53 |
Right alignment (Insert leading zeros if a value is less than 18 bytes) |
|
|
2 |
71 |
Space |
|
Data Size |
18 |
73 |
Right alignment (Insert leading zeros if a value is less than 18 bytes) |
|
|
2 |
91 |
Space |
|
Status |
12 |
93 |
999999-99999 |
|
|
2 |
105 |
Space |
|
Connection Type |
3 |
107 |
LAN |
|
|
2 |
110 |
Space |
|
Host Name |
68 |
112 |
Left alignment (Fill with spaces if a value is less than 68 bytes) |
|
*1 |
: |
You must specify the date according to the format that is specified for the Date Format (DATEFMT) of the System Environment Settings. |
|
Field Name |
Size |
Start Position |
Display Format |
|---|---|---|---|
|
File ID |
50 |
1 |
Left alignment (Fill with spaces if a value is less than 50 bytes) |
|
|
2 |
51 |
Space |
|
Host Name |
68 |
53 |
Left alignment (Fill with spaces if a value is less than 68 bytes) |
|
|
2 |
121 |
Space |
|
Send and Receive Start Date |
10 |
123 |
YYYY/MM/DD (*1) |
|
|
2 |
133 |
Space |
|
Send and Receive Start Time |
8 |
135 |
HH:MM:SS |
|
|
2 |
143 |
Space |
|
Send and Receive End Time |
8 |
145 |
HH:MM:SS |
|
|
2 |
153 |
Space |
|
Record Count |
18 |
155 |
Right alignment (Insert leading zeros if a value is less than 10 bytes) |
|
|
2 |
173 |
Space |
|
Data Size |
18 |
175 |
Right alignment (Insert leading zeros if a value is less than 10 bytes) |
|
|
2 |
193 |
Space |
|
Status |
12 |
195 |
999999-99999 |
|
|
2 |
207 |
Space |
|
Connection Type |
3 |
209 |
LAN, PPP, or SAN |
|
*1 |
: |
You must specify the date according to the format specified as Date Format (DATEFMT) in the System Environment Settings. |
|
Field Name |
Size |
Start Position |
Display Format |
|---|---|---|---|
|
File ID |
50 |
1 |
Left alignment (Fill with spaces if a value is less than 50 bytes) |
|
|
2 |
51 |
Space |
|
Host Name |
68 |
53 |
Left alignment (Fill with spaces if a value is less than 68 bytes) |
|
|
2 |
121 |
Space |
|
Send and Receive Start Date |
10 |
123 |
YYYY/MM/DD (*1) |
|
|
2 |
133 |
Space |
|
Send and Receive Start Time |
8 |
135 |
HH:MM:SS |
|
|
2 |
143 |
Space |
|
Send and Receive End Time |
8 |
145 |
HH:MM:SS |
|
|
2 |
153 |
Space |
|
Record Count |
18 |
155 |
Right alignment (Insert leading zeros if a value is less than 10 bytes) |
|
|
2 |
173 |
Space |
|
Data Size |
18 |
175 |
Right alignment (Insert leading zeros if a value is less than 10 bytes) |
|
|
2 |
193 |
Space |
|
Status |
12 |
195 |
999999-99999 |
|
|
2 |
207 |
Space |
|
Connection Type |
3 |
209 |
LAN, PPP, or SAN |
|
|
2 |
212 |
Space |
|
File Name |
200 |
214 |
File name to send and receive Left alignment (padding with spaces if a value is less than 200 bytes) |
|
*1 |
: |
You must specify the date according to the format specified as Date Format (DATEFMT) in the System Environment Settings. |
Output example
-
Displaying Send Log to Standard Output
FILEID HOSTNAME START DAY START TIME END TIME RECORD STATUS COUNT FILE0001 AS400 2017/12/29 15:33:02 15:33:02 454 0000-0000 FILE0001 AS400 2017/12/29 16:51:52 16:51:53 454 0000-0000 FILE0001 AS400 2017/12/29 15:23:27 15:23:27 454 0000-0000 -
Displaying Receive Log to Standard Output
HOSTNAME FILEID START DAY START TIME END TIME RECORD STATUS COUNT AS400 FILE0002 2017/12/29 21:43:48 21:43:48 0 0828-0000 WINDOWSP FILE0002 2017/12/29 21:55:07 21:55:08 5 0000-0000 -
Outputting File with Parameter "C=" Specified (Common to Send Log and Receive Log)
FILE0001 AS400 2017/12/29 14:13:41 14:13:41 0000000454 0000040860 000000-000000 AS400 FILE0001 AS400 2017/12/29 22:12:49 22:12:49 0000000000 0000000000 000710-000000 AS400 FILE0001 AS400 2017/12/29 22:13:23 22:13:23 0000000000 0000000000 000710-000000 AS400 FILE0001 AS400 2017/12/29 22:13:56 22:13:56 0000000000 0000000000 000710-000000 AS400
-
Output of the file with the parameter "V5=" specified (common to Send Log and Receive Log)
FILE0001 AS400 2017/12/29 15:33:02 15:33:02 000000000000000454 000000000000040860 000000-00000 LAN AS400 FILE0001 AS400 2017/12/29 22:12:49 22:12:49 000000000000000000 000000000000000000 000710-00000 LAN AS611
-
Output of the file with the parameter "V8=" specified (common to Send Log and Receive Log)
FILE0001TOKYO8TO8NAGOYA AS400 2017/12/29 15:03:15 15:03:16 000000000000000454 000000000000040860 000000-00000 LAN FILE0001TOKYO8TO8NAGOYA AS400 2017/12/29 15:03:30 15:03:30 000000000000000454 000000000000040860 000000-00000 LAN
-
Output of file with the parameter "V84=" specified (common to Send Log and Receive Log)
FILE0001TOKYO8TO8NAGOYA AS400 2017/12/29 15:03:15 15:03:16 000000000000000454 000000000000040860 000000-00000 LAN HULDLIB/HUL001(SNDDATA) FILE0001TOKYO8TO8NAGOYA AS400 2017/12/29 15:03:30 15:03:30 000000000000000454 000000000000040860 000000-00000 LAN HULDLIB/HUL001(SNDDATA)