The 64-Bit Parameter List - mfx - 3.1

Syncsort™ MFX Programmers Guide

Product type
Software
Portfolio
Integrate
Product family
Syncsort™ Software
Product
Syncsort™ MFX > MFX
Version
3.1
Language
English
Content type
Programmer’s Guide
Product name
Syncsort™ MFX
Title
Syncsort™ MFX Programmers Guide
Copyright
2024
First publish date
2010
Last updated
2024-11-06
Published on
2024-11-06T17:38:26.716054

The 64-bit parameter list should be used when you have E15, E32, or E35 user exits that run in AMODE64 and would like to pass records with 64-bit addresses back to MFX. These exits can either reside in the invoking program or, for E15 and E35, be in the load modules that are defined on the MODS statement using the N64 link-editing code.

To use the 64-bit parameter list, you must use either SORT64 or ICEMAN64 as the entry point name in the system macro that you use to invoke MFX. A 64-bit Register 1 should point to the parameter list.

The parameter list is X’88’ long. It defines the same information as is defined in the 31-bit parameter list, with the addition of 64-bit addresses and exit AMODEs for some fields. Except for the flag bit indicators, the entries are each 8 bytes, which allows for 64-bit addresses for some entries. The MFX control statement images and an optional ALTSEQ translation table can reside above the bar (that is, have a 64-bit address). The other entries have binary zeros in the first 4 bytes.

Table 52 provides an explanation of the contents of the extended parameter list. All bits and bytes indicated as reserved should be set to zero when creating the parameter list. All full 8-byte addresses in the list are either a 64-bit address, or a 24 or 31-bit address left-padded with binary zeros. For the exit AMODE flag bits, exactly one of the bits should be set for each exit whose address is specified in the parameter list. The exit AMODE flag bits do not apply to exits which are defined in a MODS statement.

Table 1. The Extended Parameter List

Displacement

Hex        Decimal

Length

Bit

Field

0

0

8

 

C’PL64SORT’ (identifier)

8

8

1

X’80’

AMODE 24 for E15 Exit or E32

X’40’

AMODE 31 for E15 Exit or E32

X’20’

AMODE 64 for E15 Exit or E32

X’10’

AMODE 24 for E35 Exit

X’08’

AMODE 31 for E35 Exit

X’04’

AMODE 64 for E35 Exit

X’02’

AMODE 24 for E18 Exit

X’01’

AMODE 31 for E18 Exit

9

9

1

X’80’

Reserved

X’40’

AMODE 24 for E39 Exit

X’20’

AMODE 31 for E39 Exit

X’10’

Reserved

X’08’

1: E15/E32 64-bit Parameter List

0: E15/E32 31-bit Parameter List

X’04’

1: E35 64-bit Parameter List

0: E35 31-bit Parameter List

X’02’

Reserved

X’01’

Reserved

A

A

13

 

Reserved

17

23

1

X’80’

1: Using Blocked E15 Exit

X’40’

0: Using Blocked E35 Exit

X’20’

Reserved

X’01’

Reserved

18

24

8

 

Address of halfword containing length of control statement images, followed by images (zeros if none)

20

32

8

 

F’0’, Address of user exit E15 or E32(zeros if none)

28

40

8

 

F’0’, Address of user exit E35 (zeros if none)

30

48

8

 

F’0’, Address of user exit address constant (zeros if none)

38

56

8

 

Address of ALTSEQ translation table(zeros if none)

40

64

8

 

F’0’, Address of ESTAE area (zeros if none)

48

72

8

 

F’0’, Address of user exit E18 (zeros if none)

50

80

8

 

F’0’, Address of user exit E39 (zeros if none)

58

88

8

 

F’0’, Call identifier (C’nnnn’) (zeros if none)

60

96

8

 

64-bit Address of user block list parameter area used by blocked E15 and/or E35

68

104

32

 

Reserved      

 

Block List Parameters for E15/E35 User Exits provides an explanation of the E15 and E35 user exit parameters available in the 64-bit parameter list, which support the transfer of blocks of records between MFX and the E15/E35 user exits.

Table 2. Block List Parameters for E15/E35 User Exits

Displacement

Hex       Decimal

Length

Bit

Field

Block List Parameters for E15 Exit

0

0

8

D

Address of User Block List Area

8

8

8

D

Maximal length of blocks with records at each return to SORT (for Block List Type 2 only)

10

16

8

D

Maximal number of blocks with records at each return to DFSORT (for Block ListType 1 or Type 2)

18

24

4

F

Maximal length of record

1C

28

1

C

Format of record (F-FLR/V-VLR)

1D

29

1

X

Block List Type for 15 exit (1/2/...)

1E

30

2

XL2

Reserved

Block List Parameters for E35 Exit

0

0

8

D

Address of User Block List Area

8

8

8

D

Maximal length of blocks with records at each return to SORT (for Block List Type 2 only)

10

16

8

D

Maximal number of blocks with records at each return to DFSORT (for Block ListType 1 or Type 2)

18

24

4

F

Maximal length of record

1C

28

1

C

Format of record (F-FLR/V-VLR)

1D

29

1

X

Block List Type 1 for 35 exit (1/2/...)

1E

30

2

XL2

Reserved