program internal interface services. IBM MVS Programming: Authorized Assembler Services

Contents

Figures . . . . . . . . . . . . . . xiii

Tables . . . . . . . . . . . . . . . xv

About this information . . . . . . . xvii

Who should use this information.

.

.

.

.

.

. xvii

How to use this information .

.

.

.

.

.

.

. xvii z/OS information .

.

.

.

.

.

.

.

.

.

.

. xvii

How to send your comments to IBM xix

If you have a technical problem .

.

.

.

.

.

. xix

Summary of changes . . . . . . . . xxi

Summary of changes for z/OS Version 2 Release 3 xxi

Summary of changes for z/OS Version 2 Release 2 xxi

z/OS Version 2 Release 1 summary of changes .

. xxii

||

Chapter 1. Using the services . . . . . 1

Compatibility of MVS macros.

.

.

.

.

.

.

.

. 1

Addressing mode (AMODE) .

.

.

.

.

.

.

.

. 2

Address space control (ASC) mode .

.

.

.

.

.

. 3

ALET qualification .

.

.

.

.

.

.

.

.

.

. 4

User parameters .

.

.

.

.

.

.

.

.

.

.

. 4

Telling the system about the execution environment 6

Specifying a macro version number.

.

.

.

.

.

. 7

How to request a macro version using PLISTVER 7

Register use .

.

.

.

.

.

.

.

.

.

.

.

.

. 8

Handling return codes and reason codes .

.

.

.

. 9

Handling program errors .

.

.

.

.

.

.

.

. 10

Handling environmental and system errors .

.

. 10

Using X-macros .

.

.

.

.

.

.

.

.

.

.

.

. 11

Macro forms .

.

.

.

.

.

.

.

.

.

.

.

.

. 12

Conventional list form macros .

.

.

.

.

.

. 12

Alternative list form macros .

.

.

.

.

.

.

. 13

Coding the macros .

.

.

.

.

.

.

.

.

.

.

. 13

Continuation lines .

.

.

.

.

.

.

.

.

.

. 16

Coding the callable services .

.

.

.

.

.

.

.

. 16

Including equate (EQU) statements .

.

.

.

. 17

Link-editing linkage-assist routines .

.

.

.

. 17

Service summary .

.

.

.

.

.

.

.

.

.

.

. 18

Chapter 2. ALESERV — Control entries in the access list . . . . . . . . . . 29

Description .

.

.

.

.

.

.

.

.

.

.

.

.

. 29

Environment .

.

.

.

.

.

.

.

.

.

.

.

. 29

Programming requirements .

.

.

.

.

.

.

. 30

Restrictions .

.

.

.

.

.

.

.

.

.

.

.

. 30

Input register information .

.

.

.

.

.

.

. 30

Output register information .

.

.

.

.

.

.

. 30

Performance implications .

.

.

.

.

.

.

.

. 31

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 31

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 32

ABEND codes .

.

.

.

.

.

.

.

.

.

.

. 35

Return codes .

.

.

.

.

.

.

.

.

.

.

.

. 36

© Copyright IBM Corp. 1988, 2017

Example .

.

.

.

.

.

.

.

.

.

.

.

.

. 41

ALESERV - List form .

.

.

.

.

.

.

.

.

.

. 41

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 41

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 42

ALESERV - Execute form .

.

.

.

.

.

.

.

.

. 42

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 42

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 43

Chapter 3. ASCRE — Create address spaces . . . . . . . . . . . . . . . 45

Description .

.

.

.

.

.

.

.

.

.

.

.

.

. 45

Environment .

.

.

.

.

.

.

.

.

.

.

.

. 45

Programming requirements .

.

.

.

.

.

.

. 45

Restrictions .

.

.

.

.

.

.

.

.

.

.

.

. 46

Register information .

.

.

.

.

.

.

.

.

. 46

Performance implications .

.

.

.

.

.

.

.

. 46

Other implications .

.

.

.

.

.

.

.

.

.

. 46

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 47

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 48

Return and reason codes .

.

.

.

.

.

.

.

. 52

Example .

.

.

.

.

.

.

.

.

.

.

.

.

. 53

ASCRE - List form .

.

.

.

.

.

.

.

.

.

.

. 54

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 54

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 55

ASCRE - Execute form.

.

.

.

.

.

.

.

.

.

. 55

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 55

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 56

Chapter 4. ASDES — Terminate an address space . . . . . . . . . . . 57

Description .

.

.

.

.

.

.

.

.

.

.

.

.

. 57

Environment .

.

.

.

.

.

.

.

.

.

.

.

. 57

Programming requirements .

.

.

.

.

.

.

. 57

Output register information .

.

.

.

.

.

.

. 57

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 58

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 58

Return and reason codes .

.

.

.

.

.

.

.

. 59

Chapter 5. ASEXT — Extract address space parameters . . . . . . . . . . 61

Description .

.

.

.

.

.

.

.

.

.

.

.

.

. 61

Environment .

.

.

.

.

.

.

.

.

.

.

.

. 61

Programming requirements .

.

.

.

.

.

.

. 61

Restrictions .

.

.

.

.

.

.

.

.

.

.

.

. 61

Register information .

.

.

.

.

.

.

.

.

. 61

Performance implications .

.

.

.

.

.

.

.

. 62

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 62

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 62

Return and reason codes .

.

.

.

.

.

.

.

. 62

Chapter 6. ATSET — Set authorization table. . . . . . . . . . . . . . . . 65

Description .

.

.

.

.

.

.

.

.

.

.

.

.

. 65

Related macros .

.

.

.

.

.

.

.

.

.

.

. 65

iii

Environment .

.

.

.

.

.

.

.

.

.

.

.

. 65

Programming requirements .

.

.

.

.

.

.

. 65

Restrictions .

.

.

.

.

.

.

.

.

.

.

.

. 65

Input register information .

.

.

.

.

.

.

. 65

Output register information .

.

.

.

.

.

.

. 66

Performance implications .

.

.

.

.

.

.

.

. 66

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 66

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 67

ABEND codes .

.

.

.

.

.

.

.

.

.

.

. 67

Return codes .

.

.

.

.

.

.

.

.

.

.

.

. 67

Examples .

.

.

.

.

.

.

.

.

.

.

.

.

. 67

Related macros .

.

.

.

.

.

.

.

.

.

.

. 103

Environment .

.

.

.

.

.

.

.

.

.

.

. 103

Programming requirements.

.

.

.

.

.

.

. 103

Restrictions .

.

.

.

.

.

.

.

.

.

.

.

. 103

Input register information .

.

.

.

.

.

.

. 103

Output register information .

.

.

.

.

.

. 104

Performance implications .

.

.

.

.

.

.

. 104

Syntax.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 104

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 104

ABEND codes .

.

.

.

.

.

.

.

.

.

.

. 105

Return codes .

.

.

.

.

.

.

.

.

.

.

. 105

Examples .

.

.

.

.

.

.

.

.

.

.

.

.

. 105

Chapter 7. ATTACH and ATTACHX —

Create a subtask . . . . . . . . . . 69

ATTACH and ATTACHX description .

.

.

.

.

. 69

Environment .

.

.

.

.

.

.

.

.

.

.

.

. 70

Programming requirements .

.

.

.

.

.

.

. 70

Restrictions .

.

.

.

.

.

.

.

.

.

.

.

. 70

Input register information .

.

.

.

.

.

.

. 70

Output register information .

.

.

.

.

.

.

. 70

Performance implications .

.

.

.

.

.

.

.

. 71

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 71

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 73

ABEND codes .

.

.

.

.

.

.

.

.

.

.

. 81

Return codes .

.

.

.

.

.

.

.

.

.

.

.

. 81

Example 1 .

.

.

.

.

.

.

.

.

.

.

.

.

. 82

Example 2 .

.

.

.

.

.

.

.

.

.

.

.

.

. 82

Example 3 .

.

.

.

.

.

.

.

.

.

.

.

.

. 83

Example 4 .

.

.

.

.

.

.

.

.

.

.

.

.

. 83

ATTACHX - Create a subtask .

.

.

.

.

.

.

. 83

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 83

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 86

Example 1 .

.

.

.

.

.

.

.

.

.

.

.

.

. 89

Example 2 .

.

.

.

.

.

.

.

.

.

.

.

.

. 89

ATTACH and ATTACHX - List form .

.

.

.

.

. 90

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 91

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 93

ATTACH and ATTACHX - Execute form .

.

.

. 93

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 94

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 96

Chapter 10. AXRES — Reserve authorization index . . . . . . . . . 107

Description .

.

.

.

.

.

.

.

.

.

.

.

.

. 107

Related macros .

.

.

.

.

.

.

.

.

.

.

. 107

Environment .

.

.

.

.

.

.

.

.

.

.

. 107

Programming requirements.

.

.

.

.

.

.

. 107

Restrictions .

.

.

.

.

.

.

.

.

.

.

.

. 107

Input register information .

.

.

.

.

.

.

. 107

Output register information .

.

.

.

.

.

. 108

Performance implications .

.

.

.

.

.

.

. 108

Syntax.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 108

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 109

ABEND codes .

.

.

.

.

.

.

.

.

.

.

. 109

Return codes .

.

.

.

.

.

.

.

.

.

.

. 109

Examples .

.

.

.

.

.

.

.

.

.

.

.

.

. 109

Chapter 11. AXREXX - System REXX services . . . . . . . . . . . . . . 111

Description .

.

.

.

.

.

.

.

.

.

.

.

.

. 111

Environment.

.

.

.

.

.

.

.

.

.

.

.

. 111

Programming requirements .

.

.

.

.

.

.

. 112

Restrictions .

.

.

.

.

.

.

.

.

.

.

.

. 112

Input register information .

.

.

.

.

.

.

. 112

Output register information .

.

.

.

.

.

. 112

Performance implications .

.

.

.

.

.

.

. 112

Syntax .

.

.

.

.

.

.

.

.

.

.

.

.

.

. 112

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 115

ABEND codes .

.

.

.

.

.

.

.

.

.

.

. 120

Return and reason codes .

.

.

.

.

.

.

. 120

Examples .

.

.

.

.

.

.

.

.

.

.

.

.

. 134

Chapter 8. AXEXT — Extract authorization index . . . . . . . . . 99

Description .

.

.

.

.

.

.

.

.

.

.

.

.

. 99

Related macros .

.

.

.

.

.

.

.

.

.

.

. 99

Environment .

.

.

.

.

.

.

.

.

.

.

.

. 99

Programming requirements .

.

.

.

.

.

.

. 99

Restrictions .

.

.

.

.

.

.

.

.

.

.

.

. 99

Input register information .

.

.

.

.

.

.

. 99

Output register information .

.

.

.

.

.

.

. 99

Performance implications .

.

.

.

.

.

.

. 100

Syntax.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 100

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 100

ABEND codes .

.

.

.

.

.

.

.

.

.

.

. 101

Return codes .

.

.

.

.

.

.

.

.

.

.

. 101

Examples .

.

.

.

.

.

.

.

.

.

.

.

.

. 101

Chapter 9. AXFRE — Free authorization index . . . . . . . . . 103

Description .

.

.

.

.

.

.

.

.

.

.

.

.

. 103

iv

z/OS MVS Authorized Assembler Services Reference ALE-DYN

Chapter 12. AXSET — Set authorization index . . . . . . . . . 135

Description .

.

.

.

.

.

.

.

.

.

.

.

.

. 135

Related macros .

.

.

.

.

.

.

.

.

.

.

. 135

Environment .

.

.

.

.

.

.

.

.

.

.

. 135

Programming requirements.

.

.

.

.

.

.

. 135

Restrictions .

.

.

.

.

.

.

.

.

.

.

.

. 135

Input register information .

.

.

.

.

.

.

. 135

Output register information .

.

.

.

.

.

. 136

Performance implications .

.

.

.

.

.

.

. 136

Syntax.

.

.

.

.

.

.

.

.

.

.

.

.

.

. 136

Parameters .

.

.

.

.

.

.

.

.

.

.

.

. 136

ABEND codes .

.

.

.

.

.

.

.

.

.

.

. 137

Return codes .

.

.

.

.

.

.

.

.

.

.

. 137

Examples .

.

.

.

.

.

.

.

.

.

.

.

.

. 137