Multiple Receive File Edit

When HULFT can no longer store the data in the Receive file due to reasons such as insufficient disk space, Multiple Receive leaves incomplete data in the Receive file when it ends. When this occurs, it is necessary to ensure consistency between the Multiple Receive Information files and the Receive file. If you need to receive the data again from the top for some reason, because HULFT appends new data to previously received data, you must delete the previously received data before you receive new data.

In cases like this, you can easily ensure the consistency of the Receive file by using the Multiple Receive File Edit program (XRSTORE). In addition, you can display the contents of the Multiple Receive Information file, and extract from the Receive file the data that matches the specified host name, date, and time.

(1) Multiple Receive File Edit Program (XRSTORE)

Program Name

XRSTORE

Execution parameters (for EXEC statement)

            a 
[{EXT|REPAIR|LIST|CLEAR}]

a. Modification method
EXT:

Extract data that matches the specified host name, date, and time from the Multiple Receive file and write the data to an output file.

REPAIR:

Repair the Multiple Receive file based on the information in the Multiple Receive Information file if merging of data in the Multiple Receive file fails.

LIST:

Output a list of the description contents of the Multiple Receive Information file.

CLEAR:

Initialize the Multiple Receive Information file and the Multiple Receive file.

Defaulting this parameter sets 'EXT.'

XRSYSIN Definition Card

This card defines the System Environment Settings of HULFT system. For details on the definitions, refer to the explanation of the System Environment Settings in 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

The following shows the format of the definition card for editing the Multiple Receive file:

Format of definition card

            a                       b               c 
[HOST=xxxxxxxx...xxx][,YMD=date1[-date2]][,TIME=hhmmss1[-hhmmss2]] 
       d 
[{,MOD|REP}]

= Remarks =

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. Host name

This parameter defines the host name for the extraction target. (Optional)

Set alphanumeric characters within 50 bytes starting with an uppercase alphabetic character for this parameter.

When you default the Date, be sure to define this parameter.

b. Date

This parameter defines the date for the extraction target. (Optional)

Specify this parameter with a numeric string of 8 bytes.

Define the date in the date format that is specified 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.

For the format 'YMD=date1,' the data which matches date1 is extracted.

For the format 'YMD=date1-date2,' the data which falls within the specified date range from date1 to date2 is extracted. The dates defined as date1 and date2 are included.

When you default the Host Name, be sure to define this parameter.

c. Time

This parameter defines the time for the extraction target. (Optional)

Specify this parameter with a numeric string of 6 bytes.

Specify the time in either of the following formats:

  • TIME=hhmmss1

  • TIME=hhmmss1-hhmmss2

When you use the format 'TIME=hhmmss1-hhmmss2,' hhmmss1 must be earlier than hhmmss2.

For the format 'TIME=hhmmss1,' the data which matches hhmmss1 is extracted.

For the format 'TIME=hhmmss1-hhmmss2,' the data which falls within the specified time range from hhmmss1 to hhmmss2 is extracted. The times defined as hhmmss1 and hhmmss2 are included.

If you do not define the Date, but define the Time, HULFT automatically sets the date as the date on which the Multiple Receive File Edit program (XRSTORE) was executed.

d. Output mode

This parameter selects the output mode for the output file. (Optional)

MOD:

Append output data to the output file. HULFT appends data to the output file whose attribute is the same as that of the Multiple Receive file.

REP:

Overwrite the output file with output data.

Defaulting this parameter sets 'REP.'

Format of input and output files

 

DD Name

File Organization

Record Length and Block Size

Record Format

Multiple Receive Information File

XRINF

Sequential Organization

Record Length: 110 bytes

Block Size: 110 bytes

Fixed-length blocked format

Multiple Receive File

XRIN

Sequential Organization

Any

Any

Output File

XROUT

Sequential Organization

Same as the Multiple Receive file

Same as the Multiple Receive file

Combinations of parameters and DD names

Parameter

XRINF

XRIN

XROUT

EXT

Multiple Receive Information File

Multiple Receive File

Output file

REPAIR

Multiple Receive Information File

Multiple Receive File

Multiple Receive file after repair

LIST

Multiple Receive Information File

Not specified

Not specified

CLEAR

Multiple Receive Information File

Not specified

Multiple Receive File

Format of Multiple Receive Information File

Field Name

Byte Count

Remarks

Sending Host Name

X

8

The name of the sending host

Send Date

9

8

YYYYMMDD

Send Time

9

8

HHMMSSmm

Record Start Position 1

P

5

The start position of the relevant record that HULFT stored in the Receive file

Record End Position 1

P

5

The end position of the relevant record that HULFT stored in the Receive file

Sending Host Name

X

50

The name of the sending host

Record Start Position 2 (*1)

P

10

The start position of the relevant record that HULFT stored in the Receive file

Record End Position 2 (*1)

P

10

The end position of the relevant record that HULFT stored in the Receive file

X

:

Character

P

:

Pack

9

:

Unsigned External Decimal

*1

:

The same content as Record Start Position 1 and Record End Position 1 is stored.

Data Set Name and Creation Volume Serial of Multiple Receive Information file

Data Set Name

Receive file name.CNTL

Creation Volume Serial

Same volume serial number as the Receive file

Example of JCL

Example of JCL 1

The following shows an example of the JCL for extracting data from the Multiple Receive file:

//XRSTORE  JOB  CLASS=A,MSGCLASS=B                                              
//XRSTORE  EXEC PGM=XRSTORE,PARM='EXT'                                          
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//XRINF    DD   DSN=HULFT.RCV.CNTL,DISP=SHR,UNIT=SYSDA,VOL=SER=HUL001           
//XRIN     DD   DSN=HULFT.RCV,DISP=SHR,UNIT=SYSDA,VOL=SER=HUL001                
//XROUT    DD   DSN=HULFT.INF.FILE,DISP=(NEW,KEEP,DELETE),UNIT=SYSDA,           
//             VOL=SER=HUL001,SPACE=(TRK,(5,1),RLSE)                            
//XRPRINT  DD   SYSOUT=*                                                        
//XRCRD    DD   *                                                               
HOST=ZOS,REP                                                                    
//

DD Name

Value

Description

STEPLIB

HULFT.LOAD

HULFT load module library

XRSYSIN

HULFT.PARMLIB(HULPRM)

System Environment Settings File

XRINF

HULFT.RCV.CNTL

Multiple Receive Information File

XRIN

HULFT.RCV

Multiple Receive File

XROUT

HULFT.INF.FILE

Output File

Parameter Name

Value

Description

UNIT

SYSDA

UNIT

VOL=SER

HUL001

Volume Name

Example of JCL 2

The following shows an example of the JCL for displaying the contents of the Multiple Receive Information file as a list:

//XRSTORE  JOB  CLASS=A,MSGCLASS=B                                              
//XRSTORE  EXEC PGM=XRSTORE,PARM='LIST'                                         
//STEPLIB  DD   DSN=HULFT.LOAD,DISP=SHR                                         
//XRSYSIN  DD   DSN=HULFT.PARMLIB(HULPRM),DISP=SHR                              
//XRINF    DD   DSN=HULFT.RCV.CNTL,DISP=SHR,UNIT=SYSDA,VOL=SER=HUL001           
//XRPRINT  DD   SYSOUT=*                                                        
//

DD Name

Value

Description

STEPLIB

HULFT.LOAD

HULFT load module library

XRSYSIN

HULFT.PARMLIB(HULPRM)

System Environment Settings File

XRINF

HULFT.RCV.CNTL

Multiple Receive Information File

List Example

                                                                                                                        
  HOST-NAME                                             DATE       TIME       START-POINT         RECORD-COUNT  
  MVS-ST                                             2015/12/01  15:18:55                   1                  77
  HP-02                                              2015/12/01  16:45:00                  78                 100
  WINDOWS-XP99                                       2015/12/01  16:51:00                 178                 270