Format of the 64-bit parameter list

Figure 1 shows the format of the 64-bit parameter list. As indicated, some 64-bit fields must contain zeros in the first 32 bits as shown in Figure 1. You must pass the pointer to the parameter list in 64-bit register 1.

The DFSORT target library, SICEUSER, contains a mapping macro called ICEPL64, which provides a separate Assembler DSECT for the 64-bit invocation parameter list.

The 8-character identifier 'PL64SORT' must be present at the start of the parameter list. The list must be 136 bytes long with parameters or zeros specified in the indicated positions. Each parameter is 64-bits wide (8 bytes) and must contain a 64-bit address or a clean 31-bit address as indicated in the description.

Figure 1. The 64-Bit Parameter List

Detailed specifications for each of the entries in the parameter list follow:

Byte (dec)

Explanation

0-7

C'PL64SORT' identifier used to indicate the 64-bit invocation parameter list has been specified.

8

Bit 0

Indicates 24-bit addressing mode (AMODE 24) will be used when the E15 or E32 exit is entered.

0 = Do not enter the E15 or E32 with 24-bit addressing in effect.
1 = Enter the E15 or E32 with 24-bit addressing in effect.

Bit 1

Indicates 31-bit addressing mode (AMODE 31) will be used when the E15 or E32 exit is entered.

0 = Do not enter the E15 or E32 with 31-bit addressing in effect.
1 = Enter the E15 or E32 with 31-bit addressing in effect.

Bit 2

Indicates 64-bit addressing mode (AMODE 64) will be used when the E15 or E32 exit is entered.

0 = Do not enter the E15 or E32 with 64-bit addressing in effect.
1 = Enter the E15 or E32 with 64-bit addressing in effect.

Note: If an E15 or E32 is used, only one of the E15 or E32 AMODE bits described previously can be set. If more than one E15 AMODE bit is set, DFSORT will terminate.

Bit 3

Indicates 24-bit addressing mode (AMODE 24) will be used when the E35 exit is entered.

0 = Do not enter the E35 with 24-bit addressing in effect.
1 = Enter the E35 with 24-bit addressing in effect.

Bit 4

Indicates 31-bit addressing mode (AMODE 31) will be used when the E35 exit is entered.

0 = Do not enter the E35 with 31-bit addressing in effect.
1 = Enter the E35 with 31-bit addressing in effect.

Bit 5

Indicates 64-bit addressing mode (AMODE 64) will be used when the E35 exit is entered.

0 = Do not enter the E35 with 64-bit addressing in effect.
1 = Enter the E35 with 64-bit addressing in effect.

Note: If an E35 is used, only one of the previous E35 AMODE bits can be set. If more than one E35 AMODE bit is set, DFSORT will terminate.

Bit 6

Indicates 24-bit addressing mode (AMODE 24) will be used when the E18 exit is entered.

0 = Do not enter the E18 with 24-bit addressing in effect.
1 = Enter the E18 with 24-bit addressing in effect.

Bit 7

Indicates 31-bit addressing mode (AMODE 31) will be used when the E18 exit is entered.

0 = Do not enter the E18 with 31-bit addressing in effect.
1 = Enter the E18 with 31-bit addressing in effect.

Note: If an E18 is used, only one of the previous E18 AMODE bits can be set. If more than one E18 AMODE bit is set, DFSORT will terminate.

9

Bit 0

Reserved. Must be set to zero.

Bit 1

Indicates 24-bit addressing mode (AMODE 24) will be used when the E39 exit is entered.

0 = Do not enter the E39 with 24-bit addressing in effect
1 = Enter the E39 with 24-bit addressing in effect.

Bit 2

Indicates 31-bit addressing mode (AMODE 31) will be used when the E39 exit is entered.

0 = Do not enter the E39 with 31-bit addressing in effect
1 = Enter the E39 with 31-bit addressing in effect.

Note: If an E39 is used, only one of the previous E39 AMODE bits can be set. If more than one E39 AMODE bit is set, DFSORT will terminate.

Bit 3

Reserved. Must be set to zero.

Bit 4

Indicates type of E15 or E32 exit parameter list used

0 = 32 bit exit parameter list used, 32-bit Register 1 returned from exit, and exit saves 32-bit registers in save area (Format-0 72 byte save area) pointed at by 32-bit Register 13.
1 = 64 bit exit parameter list used, 64-bit Register 1 returned from exit, and exit saves 64-bit registers in save area (Format-4 144 byte save area) pointed at by 64-bit Register 13.

Bit 5

Indicates type of E35 exit parameter list used

0 = 32 bit exit parameter list used, 32-bit Register 1 returned from exit, and exit saves 32-bit registers in save area (Format-0 72 byte save area) pointed at by 32-bit Register 13.
1 = 64 bit exit parameter list used, 64-bit Register 1 returned from exit, and exit saves 64-bit registers in save area (Format-4 144 byte save area) pointed at by 64-bit Register 13.

Bit 6

Indicates type of E18 exit parameter list used

0 = 32 bit exit parameter list used, 32-bit Register 1 returned from exit, and exit saves 32-bit registers in save area (Format-0 72 byte save area) pointed at by 32-bit Register 13.
1 = Reserved.

Bit 7

Indicates type of E39 exit parameter list used

0 = 32 bit exit parameter list used, 32-bit Register 1 returned from exit, and exit saves 32-bit registers in save area (Format-0 72 byte save area) pointed at by 32-bit Register 13.
1 = Reserved.

Note: In the previous situations when a 32-bit Register 1 is returned, the high half of Register 1 will be ignored by DFSORT when the exit returns to DFSORT.

10-23

Reserved. Must be set to zeros.

24-31

The address of the area containing the DFSORT control statements, if any; otherwise, all zeros. Can be a 64-bit address, a clean 31-bit address or a clean 24-bit address.

Refer to the previous section for the format of the control statement area.

Attention: The area must start with a two-byte length field. If zeros are specified, all the required control statements must be provided in DFSORT DD DFSPARM or SORTCNTL.

32-39

The address of the E15 or E32 user exit routine that the program has placed in main storage (for example, via LOAD), if any; otherwise, all zeros. Must be a clean 31-bit address or a clean 24-bit address.

40-47

The address of the E35 user exit routine that the program has placed in main storage (for example, via LOAD), if any; otherwise, all zeros. Must be a clean 31-bit address or a clean 24-bit address.

48-55

The 4-byte user exit address constant will be passed to the E15, E32 or E35 user exit routines.

Note: The user exit address constant must not be used for a Conventional merge or tape work data set sort application.

56-63

The address of a 256-byte ALTSEQ translation table supplied instead of an ALTSEQ statement, if any; otherwise, all zeros. It can be a 64-bit address, a clean 31-bit address or a clean 24-bit address. You can use this option to override an ALTSEQ installation option. For full override and applicability details, see Specification/override of DFSORT options.

64-71

The address of a 112-byte work area where ESTAE information is saved, or all zeros if the ESTAE information is not saved. Must be a clean 31-bit address or a clean 24-bit address. If a system or user exit abend occurs, the DFSORT recovery routine will copy the first 112 bytes of the software diagnostic work area (SDWA) into this area before returning to the ESTAE recovery routine.

72-79

The address of the E18 user exit routine that the program has placed in main storage (for example, via LOAD), if any; otherwise, all zeros. Must be a clean 31-bit address or a clean 24-bit address.

Note: This parameter is ignored for a merge application and for a tape work data set sort application.

80-87

The address of the E39 user exit routine that the program has placed in main storage (for example, via LOAD), if any; otherwise, all zeros. Must be a clean 31-bit address or a clean 24-bit address.

Note: This parameter is ignored for a conventional merge application and for a tape work data set sort application.

88-95

Four bytes of zeros followed by 4 characters to be used as an identifier for this call to DFSORT. This field can be used to uniquely identify each call to DFSORT from a program that calls DFSORT more than once. DFSORT prints message ICE200I to display the 4-character identifier exactly as you specify it; the field is not checked for valid characters. If the identifier field contains zeros (X'00000000'), DFSORT does not print message ICE200I.

96-135

Reserved. Must be set to zeroes.