Exit parameter list

The assembler passes an Exit Parameter List to the user exit. On entry to the exit, Register 1 contains the address of this parameter list. Each exit is passed a separate copy of the parameter list. The parameter list includes a pointer to an Exit-Specific block that contains information for each exit type. High Level Assembler provides macro ASMAXITP to map the Exit Parameter List and the Exit-Specific Information block. Figure 1 describes the format of the Exit Parameter List, Figure 1 describes the format of the Exit-Specific Information block for the LISTING exit, and Figure 2 describes the format of the Exit-Specific Information block for the other exit types.

The high-order bit of the last pointer in the I/O exit parameter list is set to 1.

The HLASM Services Interface for I/O exits is described HLASM Services Interface.

Figure 1. Exit parameter list format

                                                        0                      31
                                                       ┌─────────────────────────┐
                                                  ┌───>│ Parameter List Version  │
                                                  │    ├─────────────────────────┤
                                                  │    │ Exit Type               │
                                                  │    ├─────────────────────────┤
                                                  │    │ Request Type            │
                                                  │    ├─────────────────────────┤
                                                  │    │ Options                 │
                                                  │    ├─────────────────────────┤
                                                  │    │ EXITCTL 1               │
                                                  │    ├─────────────────────────┤
                                                  │    │ EXITCTL 2               │
                                                  │    ├─────────────────────────┤
                                                  │    │ EXITCTL 3               │
                                                  │    ├─────────────────────────┤
                                                  │    │ EXITCTL 4               │
                                                  │    ├─────────────────────────┤
                                                  │    │ Return Code             │
                                                  │    ├─────────────────────────┤
                                                  │    │ Reason Code             │
                                                  │    ├─────────────────────────┤
                                                  │    │ Buffer Length           │
                                                  │    ├─────────────────────────┤
                                                  │    │ Error Buffer Length     │
                                                  │    ├─────────────────────────┤
                                                  │    │ Error Severity          │
                                                  │    ├─────────────────────────┤
                                                  │    │ User-Defined Field      │
                                                  │    ├─────────────────────────┤
                      0                    31     │    │ Common User Field       │
  ┌────────────┐     ┌───────────────────────┐    │    └─────────────────────────┘
  │ Register 1 ├────>│ Ptr to Request Info   ├────┘
  └────────────┘     ├───────────────────────┤         ┌─────────────────────────┐
                     │ Ptr to Buffer         ├────────>│ Buffer                  │
                     ├───────────────────────┤         └─────────────────────────┘
                     │ Ptr to Error Buffer   ├──────┐
                     ├───────────────────────┤      │  ┌─────────────────────────┐
                     │ Ptr to Exit Info      ├────┐ └─>│ Error Buffer            │
                     ├───────────────────────┤    │    └─────────────────────────┘
                     │ Ptr to DCB            │    │
                     ├───────────────────────┤    │    ┌─────────────────────────┐
                     │ Ptr to Static         ├──┐ └───>│ Exit-Specific  Block    │
                     │ Assembler Information │  │      └─────────────────────────┘
                     ├───────────────────────┤  │                                       8
                     │ Ptr to Service        │  │      ┌─────────────────/ /─────────────┐
                     │ Interface Information │  └─────>│ HLASM VRM                       │
                     └───────────────────────┘         ├─────────────────/ /─────────────┤
                                                       │ PTF Level                       │  16
                                                       ├─────────────────/ /─────────────┴────┐
                                                       │ System Id                            │
                                                       ├─────────────────/ /─────┬────────────┘
                                                       │ Numeric Version         │  4
                                                       └─────────────────────────┘

The following sections describe the Exit Parameter List.