Call for converting and comparing 28-bit cylinder addresses (IECTRKAD)

IECTRKAD is a callable service to perform conversions and compares of 28-bit cylinder addresses. The track addresses are in the form CCCCcccH, where CCCC is the 16 low order bits of the cylinder number and ccc is the 12 high order bits of it.

Cobol, PL/I, and C programs can call IECTRKAD without having to write assembler routines to invoke TRKADDR.

The caller requirements of IECTRKAD are:

Register 1 contains an address to a parameter list. Register 0 is not used. Register 13 points to a standard register 18-word save area and registers 14 and 15 have their standard usage.
Calling program can be in either 24-or 32-bit addressing mode
Calling program can be executing in any protection key and in either supervisor or problem state

The called routine, IECTRKAD, has the following characteristics:

No executable macro other than CALL and LINK is provided to call IECTRKAD.
The called routine resides in SYS1.CSSLIB and is shipped in distribution library ACSSLIB.
User program can link edit with the called routine to invoke IECTRKAD.
User program can use the LINK macro or the LOAD and CALL macros to invoke IECTRKAD.
IECTRKAD processing will use the equivalent TRKADDR function and pass the result back accordingly.
IECTRKAD is release independent; if you link or bind IECTRKAD with your program, it will run on earlier or later releases of z/OS®. This includes releases before the first availability of IECTRKAD.