List output and file output of Send Log records or Receive Log records
You can output records of the Send Log or the Receive Log as a list or a file by using batch processing.
Send Log List/File Output Program (XRSLOGL) or Receive Log List/File Output Program (XRRLOGL)
Program Name
- XRSLOGL
-
This program outputs the records of the Send Log as a list or a file.
- XRRLOGL
-
This program outputs the records of the Receive Log as a list or a file.
Execution parameters (for EXEC statement)
[HOST|C-FMT|V5-FMT|V8-FMT|V84-FMT]
- HOST
-
This parameter is defined to output Send Log records or Receive Log records by host.
Specifying this parameter outputs Send Log records or Receive Log records by host as a list.
- C-FMT
-
This parameter defines the Ver.4 format.
Specifying this parameter outputs log records to the file in the common format of HULFT Ver.4. Specify an output destination file for HULFT Ver.4.
For details on the common format of HULFT Ver.4, refer to Table 5.3 Common Format of HULFT Ver.4.
- V5-FMT
-
This parameter defines the Ver.5 format.
Specifying this parameter outputs log records to the file in the common format of HULFT Ver.5. Specify an output destination file for HULFT Ver.5.
For details on the common format of HULFT Ver.5, refer to Table 5.4 Common Format of HULFT Ver.5.
- V8-FMT
-
This parameter defines the Ver.8 format.
Specifying this parameter outputs log records to the file in the common format of HULFT Ver.8. Specify an output destination file for HULFT Ver.8.
For details on the common format of HULFT Ver.8, refer to Table 5.5 Common Format of HULFT Ver.8.
- V84-FMT
-
This parameter defines the Ver.8.4 format.
For Ver.8.4, specifying this parameter outputs log records to the file in the common format of HULFT Ver.8.4. Specify an output destination file for HULFT Ver.8.4.
For details on the common format of HULFT Ver.8.4, refer to Table 5.6 Common format of HULFT Ver.8.4.
For Ver.10, specifying this parameter outputs log records to the file in the common format of HULFT Ver.10. Specify an output destination file for HULFT Ver.10.
For details on the common format of HULFT Ver.10, refer to List output and file output of Send Log records or Receive Log records.
Defaulting this parameter outputs Send Log records by file or Receive Log records by file as a list.
XRSYSIN Definition Card
This card defines the System Environment Settings of HULFT system. For details on the definitions, refer to the following:
HULFT10 for zOS Administration Manual :
Format of definition card
OPLSELECT=Operation Log Output Option (*1) DATEFMT=Date Format
*1 |
: |
When you use the operation log output function, you must include definitions related to operation logs. For details, refer to Definitions for operation logs. |
XRCRD Definition Card
You can define up to 100 definition cards.
The following shows the format of the definition card for outputting the records of the Send Log or the Receive Log as a list.
Format of definition card
a b c [FILE-ID=fileid1 [-fileid2]] [,HOST-ID=host1 [-host2]][,YMD=date1 [-date2]]
If the definition card spans two lines, use either of the following two methods to define the definition card:
-
Describe the first line up to column 71, and then insert a hyphen (-) in column 72. Describe the second line starting in column 1.
-
Describe a line up to a comma (,) that follows a parameter, insert a single byte space, and then insert a hyphen (-) in column 71 or before.
Input contents of definition card
- a. File ID
-
This parameter defines the file ID for list output targets. (Optional)
Specify a string of alphanumeric characters (and "_" if desired) that is within 50 bytes.
To output Send Log records or Receive Log records for instant transfer as a list, specify "_INSTANT_TRANSFER_" for the file ID.
Specify this parameter in the format of 'fileid1' or 'fileid1<fileid2.' The range of the output targets includes the defined file IDs of 'fileid1' and 'fileid2.'
Defaulting this parameter sets all file IDs as output targets.
- b. Host name
-
This parameter defines the host name for list output targets. (Optional)
Specify alphanumeric characters within 50 bytes starting with an uppercase alphabetic character for this parameter.
Define the host name in either of the following formats:
-
HOST-ID=host1
-
HOST-ID=host1-host2
When you define this parameter in the format of 'HOST-ID=host1-host2,' the host names must fulfill the condition host1<host2 according to the order of the host names in the Host Information file (HULFT.HOST).
The range of the output targets includes the defined host names of 'host1' and 'host2.'
Defaulting this parameter sets all host names as output targets.
-
- c. Date
-
This parameter defines the date for list output targets. (Optional)
Specify an 8-byte numeric string for each date of this parameter.
Specify the date in the format that you defined for the Date Format (DATEFMT) in the System Environment Settings.
Specify the date in either of the following formats:
-
YMD=date1
-
YMD=date1-date2
When you use the format 'YMD=date1-date2,' date1 must be earlier than date2.
When you define this parameter with 'YMD=date1,' the program outputs the log records for date1.
For the format 'YMD=date1-date2,' the program outputs the log records which fall within the defined range from date1 to date2. The range of the output targets includes the defined host names of 'date1' and 'date2.'
Defaulting this parameter sets all dates as output targets.
HULFT searches for deletion targets based on the Send start date or the Receive start date.
-
-
Defaulting this card outputs all records of the Send Log or the Receive Log.
-
The program uses the AND condition to combine specification of the parameters (the File ID, the Host Name, and the Date) of the definition card.
Format of output destination file for Send Log records or Receive Log records
The following table shows the formats of output files to which the program outputs Send Log records or Receive Log records.
Make sure to define an output file in one of the following formats:
|
HULFT Ver.4 |
HULFT Ver.5 |
HULFT Ver.8 |
HULFT Ver.8.4 |
---|---|---|---|---|
DD Name |
XRLOGFIL |
XRLOGFIL |
XRLOGFIL |
XRLOGFIL |
File Organization |
Sequential Organization File |
Sequential Organization File |
Sequential Organization File |
Sequential Organization File |
Record Length |
158 bytes |
179 bytes |
211 bytes |
413 bytes |
Record Format |
Fixed-length blocked format |
Fixed-length blocked format |
Fixed-length blocked format |
Fixed-length blocked format |
Contents of common formats (contents of output file)
Field Name |
Number of Digits |
Display Format |
---|---|---|
File ID |
8 |
Left alignment (Spaces are padded if the string is less than 8 bytes.) |
|
2 |
Space |
Host Name |
8 |
Left alignment (Spaces are padded if the string is less than 8 bytes.) |
|
2 |
Space |
Send Start Date or Receive Start Date |
10 |
YYYY/MM/DD |
|
2 |
Space |
Send Start Time or Receive Start Time |
8 |
HH:MM:SS |
|
2 |
Space |
Send End Time or Receive End Time |
8 |
HH:MM:SS |
|
2 |
Space |
Record Count |
10 |
Right alignment (Leading zeros are added if the value is less than 10 bytes.) |
|
2 |
Space |
Data Size |
10 |
Right alignment (Leading zeros are added if the value is less than 10 bytes.) |
|
2 |
Space |
Status |
12 |
999999-99999 (Status code-Detail code) |
Field Name |
Number of Digits |
Display Format |
---|---|---|
File ID |
8 |
Left alignment (Spaces are padded if the string is less than 8 bytes.) |
|
2 |
Space |
Host Name |
8 |
Left alignment (Spaces are padded if the string is less than 8 bytes.) |
|
2 |
Space |
Send Start Date or Receive Start Date |
10 |
YYYY/MM/DD |
|
2 |
Space |
Send Start Time or Receive Start Time |
8 |
HH:MM:SS |
|
2 |
Space |
Send End Time or Receive End Time |
8 |
HH:MM:SS |
|
2 |
Space |
Record Count |
18 |
Right alignment (Leading zeros are added if the value is less than 18 bytes.) |
|
2 |
Space |
Data Size |
18 |
Right alignment (Leading zeros are added if the value is less than 18 bytes.) |
|
2 |
Space |
Status |
12 |
999999-99999 (Status code-Detail code) |
|
2 |
Space |
Connection Type |
3 |
LAN or SAN |
|
2 |
Space |
Host Name |
68 |
Left alignment (Spaces are padded if the string is less than 68 bytes.) |
Field Name |
Number of Digits |
Display Format |
---|---|---|
File ID |
50 |
Left alignment (Spaces are padded if the string is less than 50 bytes.) |
|
2 |
Space |
Host Name |
68 |
Left alignment (Spaces are padded if the string is less than 68 bytes.) |
|
2 |
Space |
Send Start Date or Receive Start Date |
10 |
YYYY/MM/DD (*1) |
|
2 |
Space |
Send Start Time or Receive Start Time |
8 |
HH:MM:SS |
|
2 |
Space |
Send End Time or Receive End Time |
8 |
HH:MM:SS |
|
2 |
Space |
Record Count |
18 |
Right alignment (Leading zeros are added if the value is less than 18 bytes.) |
|
2 |
Space |
Data Size |
18 |
Right alignment (Leading zeros are added if the value is less than 18 bytes.) |
|
2 |
Space |
Status |
12 |
999999-99999 (Status code-Detail code) |
|
2 |
Space |
Connection Type |
3 |
LAN |
*1 |
: |
This format follows the format that you defined for the Date Format (DATEFMT) in the System Environment Settings. |
Field Name |
Number of Digits |
Display Format |
---|---|---|
File ID |
50 |
Left alignment (Spaces are padded if the string is less than 50 bytes.) |
|
2 |
Space |
Host Name |
68 |
Left alignment (Spaces are padded if the string is less than 68 bytes.) |
|
2 |
Space |
Send Start Date or Receive Start Date |
10 |
YYYY/MM/DD (*1) |
|
2 |
Space |
Send Start Time or Receive Start Time |
8 |
HH:MM:SS |
|
2 |
Space |
Send End Time or Receive End Time |
8 |
HH:MM:SS |
|
2 |
Space |
Record Count |
18 |
Right alignment (Leading zeros are added if the value is less than 18 bytes.) |
|
2 |
Space |
Data Size |
18 |
Right alignment (Leading zeros are added if the value is less than 18 bytes.) |
|
2 |
Space |
Status |
12 |
999999-99999 (Status code-Detail code) |
|
2 |
Space |
Connection Type |
3 |
LAN |
|
2 |
Space |
File Name |
200 |
Left alignment (Spaces are padded if the string is less than 200 bytes.) |
*1 |
: |
This format follows the format that you defined for the Date Format (DATEFMT) in the System Environment Settings. |
Example of JCL
-
List output of Send Log records (by file)
//XRSLOGL JOB CLASS=A,MSGCLASS=B //XRSLOGL EXEC PGM=XRSLOGL //STEPLIB DD DSN=HULFT.LOAD,DISP=SHR //XRLOG DD DSN=HULFT.LOG,DISP=SHR //XRLOG1 DD DSN=HULFT.LOG.PATH1,DISP=SHR //XRLOG2 DD DSN=HULFT.LOG.PATH2,DISP=SHR //XRSYSIN DD DSN=HULFT.PARMLIB(HULPRM),DISP=SHR //SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) //XRPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //XRCRD DD * FILE-ID=LOOPTEST,HOST-ID=ZOS,YMD=20171229-20180131 //
DD Name
Value
Description
STEPLIB
HULFT.LOAD
HULFT load module library
XRLOG
HULFT.LOG
Send and Receive Log File ID Key File
XRLOG1
HULFT.LOG.PATH1
Send and Receive Log Host Name Key File
XRLOG2
HULFT.LOG.PATH2
Send and Receive Log Date Key File
XRSYSIN
HULFT.PARMLIB(HULPRM)
System Environment Settings File
Parameter Name
Value
Description
UNIT
SYSDA
UNIT
-
List output of Receive Log records (by host)
//XRRLOGL JOB CLASS=A,MSGCLASS=B //XRRLOGL EXEC PGM=XRRLOGL,PARM='HOST' //STEPLIB DD DSN=HULFT.LOAD,DISP=SHR //XRLOG DD DSN=HULFT.LOG,DISP=SHR //XRLOG1 DD DSN=HULFT.LOG.PATH1,DISP=SHR //XRLOG2 DD DSN=HULFT.LOG.PATH2,DISP=SHR //XRSYSIN DD DSN=HULFT.PARMLIB(HULPRM),DISP=SHR //SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) //XRPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //XRCRD DD * HOST-ID=ZOS,YMD=20171229-20180131 //
DD Name
Value
Description
STEPLIB
HULFT.LOAD
HULFT load module library
XRLOG
HULFT.LOG
Send and Receive Log File ID Key File
XRLOG1
HULFT.LOG.PATH1
Send and Receive Log Host Name Key File
XRLOG2
HULFT.LOG.PATH2
Send and Receive Log Date Key File
XRSYSIN
HULFT.PARMLIB(HULPRM)
System Environment Settings File
Parameter Name
Value
Description
UNIT
SYSDA
UNIT
-
File output of Send Log records (in Ver.4 format)
//XRSLOGL JOB CLASS=A,MSGCLASS=B //XRSLOGL EXEC PGM=XRSLOGL,PARM='C-FMT' //STEPLIB DD DSN=HULFT.LOAD,DISP=SHR //XRLOG DD DSN=HULFT.LOG,DISP=SHR //XRLOG1 DD DSN=HULFT.LOG.PATH1,DISP=SHR //XRLOG2 DD DSN=HULFT.LOG.PATH2,DISP=SHR //XRSYSIN DD DSN=HULFT.PARMLIB(HULPRM),DISP=SHR //XRLOGFIL DD DSN=HULFT.LOG.FILE,DISP=(NEW,KEEP,DELETE),UNIT=SYSDA, // VOL=SER=HUL001,DCB=(BLKSIZE=1580,LRECL=158,RECFM=FB), // SPACE=(CYL,(5,1),RLSE) //SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) //XRPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //XRCRD DD * FILE-ID=LOOPTEST,HOST-ID=ZOS,YMD=20171229-20180131 //
DD Name
Value
Description
STEPLIB
HULFT.LOAD
HULFT load module library
XRLOG
HULFT.LOG
Send and Receive Log File ID Key File
XRLOG1
HULFT.LOG.PATH1
Send and Receive Log Host Name Key File
XRLOG2
HULFT.LOG.PATH2
Send and Receive Log Date Key File
XRSYSIN
HULFT.PARMLIB(HULPRM)
System Environment Settings File
XRLOGFIL
HULFT.LOG.FILE
Output destination File
Parameter Name
Value
Description
UNIT
SYSDA
UNIT
VOL=SER
HUL001
Volume Name
-
File output of Receive Log records (in Ver.5 format)
//XRRLOGL JOB CLASS=A,MSGCLASS=B //XRRLOGL EXEC PGM=XRRLOGL,PARM='V5-FMT' //STEPLIB DD DSN=HULFT.LOAD,DISP=SHR //XRLOG DD DSN=HULFT.LOG,DISP=SHR //XRLOG1 DD DSN=HULFT.LOG.PATH1,DISP=SHR //XRLOG2 DD DSN=HULFT.LOG.PATH2,DISP=SHR //XRLOGFIL DD DSN=HULFT.LOG.FILE,DISP=(NEW,KEEP,DELETE),UNIT=SYSDA, // VOL=SER=HUL001,DCB=(BLKSIZE=1790,LRECL=179,RECFM=FB), // SPACE=(CYL,(5,1),RLSE) //XRSYSIN DD DSN=HULFT.PARMLIB(HULPRM),DISP=SHR //SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) //XRPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //XRCRD DD * FILE-ID=LOOPTEST,HOST-ID=ZOS,YMD=20171229-20180131 //
DD Name
Value
Description
STEPLIB
HULFT.LOAD
HULFT load module library
XRLOG
HULFT.LOG
Send and Receive Log File ID Key File
XRLOG1
HULFT.LOG.PATH1
Send and Receive Log Host Name Key File
XRLOG2
HULFT.LOG.PATH2
Send and Receive Log Date Key File
XRLOGFIL
HULFT.LOG.FILE
Output Destination File
XRSYSIN
HULFT.PARMLIB(HULPRM)
System Environment Settings File
Parameter Name
Value
Description
UNIT
SYSDA
UNIT
VOL=SER
HUL001
Volume Name
-
File output of Send Log records (in Ver.8 format)
//XRSLOGL JOB CLASS=A,MSGCLASS=B //XRSLOGL EXEC PGM=XRSLOGL,PARM='V8-FMT' //STEPLIB DD DSN=HULFT.LOAD,DISP=SHR //XRLOG DD DSN=HULFT.LOG,DISP=SHR //XRLOG1 DD DSN=HULFT.LOG.PATH1,DISP=SHR //XRLOG2 DD DSN=HULFT.LOG.PATH2,DISP=SHR //XRLOGFIL DD DSN=HULFT.LOG.FILE,DISP=(NEW,KEEP,DELETE),UNIT=SYSDA, // VOL=SER=HUL001,DCB=(BLKSIZE=2110,LRECL=211,RECFM=FB), // SPACE=(CYL,(5,1),RLSE) //XRSYSIN DD DSN=HULFT.PARMLIB(HULPRM),DISP=SHR //SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) //XRPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //XRCRD DD * FILE-ID=LOOPTEST,HOST-ID=ZOS,YMD=20171229-20180131 //
DD Name
Value
Description
STEPLIB
HULFT.LOAD
HULFT load module library
XRLOG
HULFT.LOG
Send and Receive Log File ID Key File
XRLOG1
HULFT.LOG.PATH1
Send and Receive Log Host Name Key File
XRLOG2
HULFT.LOG.PATH2
Send and Receive Log Date Key File
XRLOGFIL
HULFT.LOG.FILE
Output Destination File
XRSYSIN
HULFT.PARMLIB(HULPRM)
System Environment Settings File
Parameter Name
Value
Description
UNIT
SYSDA
UNIT
VOL=SER
HUL001
Volume Name
-
File output of Receive Log records (in Ver.8.4 format)
//XRRLOGL JOB CLASS=A,MSGCLASS=B //XRRLOGL EXEC PGM=XRSLOGL,PARM='V84-FMT' //STEPLIB DD DSN=HULFT.LOAD,DISP=SHR //XRLOG DD DSN=HULFT.LOG,DISP=SHR //XRLOG1 DD DSN=HULFT.LOG.PATH1,DISP=SHR //XRLOG2 DD DSN=HULFT.LOG.PATH2,DISP=SHR //XRLOGFIL DD DSN=HULFT.LOG.FILE,DISP=(NEW,KEEP,DELETE),UNIT=SYSDA, // VOL=SER=HUL001,DCB=(BLKSIZE=4130,LRECL=413,RECFM=FB), // SPACE=(CYL,(5,1),RLSE) //XRSYSIN DD DSN=HULFT.PARMLIB(HULPRM),DISP=SHR //SORTWK01 DD UNIT=SYSDA,SPACE=(CYL,(1,1)) //XRPRINT DD SYSOUT=* //SYSOUT DD SYSOUT=* //XRCRD DD * FILE-ID=LOOPTEST,HOST-ID=ZOS,YMD=20171229-20180131 //
DD Name
Value
Description
STEPLIB
HULFT.LOAD
HULFT load module library
XRLOG
HULFT.LOG
Send and Receive Log File ID Key File
XRLOG1
HULFT.LOG.PATH1
Send and Receive Log Host Name Key File
XRLOG2
HULFT.LOG.PATH2
Send and Receive Log Date Key File
XRLOGFIL
HULFT.LOG.FILE
Output Destination File
XRSYSIN
HULFT.PARMLIB(HULPRM)
System Environment Settings File
Parameter Name
Value
Description
UNIT
SYSDA
UNIT
VOL=SER
HUL001
Volume Name
Example of output lists
-
Send Log List by File
**** TRANSMISSION STATUS **** 2015.12.01 21:15 PAGE : 1 FILE ID : FILE0001 HOST NAME : ZOS13 START TIME 2015/12/01 19:46:54-19:50:35 DB : RECORD COUNT : 00000000064/00000000000 STATUS : 0000 ERROR CODE : 0000 CONNECT-TYPE : LAN HOST FILE : HULFT.V810IT.DATA1 VOLUME NO. : PROC-ID : 7377841094ABC951C000009E0000010111 START TIME 2015/12/01 19:47:17-19:47:19 DB : RECORD COUNT : 00000000000/00000000000 STATUS : 0016 ERROR CODE : 0511 CONNECT-TYPE : LAN HOST FILE : HULFT.V810IT.DATA1 VOLUME NO. : PROC-ID : 7377841094ABC951C000009E0000010111
-
Receive Log List by Host
**** TRANSMISSION STATUS(RCV)*** 2015.12.01 19:40 PAGE : 1 HOST NAME : ZOS13 FILE ID : FILE0001 START TIME 2015/12/01 17:06:04-17:09:46 RECORD COUNT : 00000000064 STATUS : 0000 ERROR CODE : 0000 CONNECT-TYPE : LAN HOST FILE : HULDATA.V800PSW.RCV2 VOLUME NO. : HUL001 PROC-ID : 7377780E557833F4D00000810000010111 START TIME 2015/12/01 17:06:21-17:06:22 RECORD COUNT : 00000000000 STATUS : 0020 ERROR CODE : 0005 CONNECT-TYPE : LAN HOST FILE : HULDATA.V800PSW.RCV2 VOLUME NO. : PROC-ID : 7377780E567995D0F00000810000010111
Example of output files
-
Send Log List (in Ver.4 format)
FILE0001 ZOS13 2015/12/01 19:46:54 19:50:35 0000000064 0000005120 000000-00000 FILE0001 ZOS13 2015/12/01 19:47:17 19:47:19 0000000000 0000000000 000016-00511
-
Receive Log List (in Ver.5 format)
FILE0001 ZOS13 2015/12/01 16:37:07 16:40:48 000000000000000064 000000000000005120 000000-00000 LAN ZOS13 FILE0001 ZOS13 2015/12/01 16:49:31 16:53:12 000000000000000064 000000000000005120 000000-00000 LAN ZOS13 FILE0001 ZOS13 2015/12/01 18:51:45 18:51:46 000000000000000000 000000000000000000 000024-00005 LAN ZOS13 FILE0001 ZOS13 2015/12/01 18:57:26 18:57:27 000000000000000000 000000000000000000 000024-00005 LAN ZOS13 FILE0001 ZOS13 2015/12/01 18:57:57 19:01:38 000000000000000064 000000000000005120 000000-00000 LAN ZOS13 FILE0001 ZOS13 2015/12/01 19:46:54 19:50:35 000000000000000064 000000000000005120 000000-00000 LAN ZOS13 FILE0001 ZOS13 2015/12/01 19:47:17 19:47:19 000000000000000000 000000000000000000 000020-00005 LAN ZOS13
-
Send Log List (in Ver.8 format)
FILE00018TOKYO8TO8NAGOYA ZOS13 2015/12/01 19:46:54 19:50:35 000000000000000064 000000000000005120 000000-00000 LAN FILE00018TOKYO8TO8NAGOYA ZOS13 2015/12/01 19:47:17 19:47:19 000000000000000000 000000000000000000 000016-00511 LAN
-
Receive Log List (in Ver.8.4 format)
FILE00018TOKYO8TO8NAGOYA ZOS13 2017/12/29 11:57:58 11:57:58 000000000000000000 000000000000000000 000016-00506 LAN HULFT.DATA.RCV FILE00018TOKYO8TO8NAGOYA ZOS13 2017/12/29 11:57:59 11:57:59 000000000000000000 000000000000000000 000016-00506 LAN HULFT.DATA.RCV