PURGE macro - is type 2, gets LOCAL, IOSUCB, CMS, and IOSYNCH locks.
Calls module IOSPURGA, entry point IGC016.
| DDNAME | cccccccc | Name of the DD statement associated with the requests being purged. |
| U/A | Indicates that the DDNAME was unavailable because the DEB address was unavailable. | |
| ******** | Indicates that a program check interruption occurred while trying to gather the DCB address or DDNAME. | |
| DCB | xxxx | Address of the DCB associated with the purge request. |
| U/A | Unavailable because PPLDSID was 0 or verified as an incorrect DEB address. | |
| **** | Indicates that a program check interruption occurred while trying to gather the DCB address. |
| 0 | PPLOPT1 Option byte 1. Bit settings are: | |||
| PPLDS | 1... | .... | If DSID purge was requested (bit 6), purge a single DSID (see PPLDSID). If zero, purge the DSID list. | |
| PPLPOST | .1.. | .... | ECBs associated with I/O requests purged should be posted with X'48'. | |
| PPLHIO | ..1. | .... | Halt the I/O requests and do not build a PIRL. | |
| PPLREL | ...1 | .... | Purge only the I/O requests marked related and associated with the argument. | |
| .... | x... | Reserved; must be zero. | ||
| PPLRB | .... | .1.. | Do not purge the RB chain for asynchronously scheduled routines. | |
| PPLTASK | .... | ..1. | If ASID purge is not specified, purge a single TCB. | |
| PPLEXR | .... | ...1 | Option byte 2 is present and contains valid information. | |
| 1-3 | PPLDSIDA | Address of the DEB, the argument used for DSID purge. | ||
| 4 | PPLCC | Completion code. If bit
7 of option byte 1 is 0, the only completion code is X'7F'. If bit 7 of option byte 1 is 1, the completion codes are as follows:
|
||
| 5-7 | PPLTCBA | Address of the TCB. | ||
| 8 | PPLDVRID | Driver ID for the DSID purge – X'00' implies EXCP is the owner. | ||
| 9-11 | PPLPIRL | This is the address of the anchor from which the purged I/O Request List (PIRL) will be chained. The anchor is a fullword whose right most 3 bytes are used for a pointer to the PIRL. If the address in the anchor is X'FFFFFF', no I/O request was purged. | ||
| 12 | PPLOPT2 | Option byte 2, present if PPLOPT1, bit 7 is 1. | ||
| PPLCAN | 1... | .... | Cancel Command request. | |
| .x.. | .... | Reserved; must be zero. | ||
| PPLMEM | ..1. | .... | Address space purge is specified. | |
| ..0. | .... | Address space purge is not specified. | ||
| PPLVC | ...1 | .... | Perform the DSID validity check. | |
| PPLOTCB | .... | 1... | Purge the I/O requests so that when they are restored they will be associated with the TCB that originated them. | |
| .... | 0... | Purge the I/O requests so that when they are restored they will be associated with the restoring TCB. | ||
| PPLTSKM | .... | .1.. | Purge called by task ending. | |
| PPLBSS | ... | ..1. | Purge was called by the RCT – bypass the status start SRBs. | |
| PPLUCB | .... | ...1 | Purge DSID by UCB only. | |
| 13 | Reserved; must be zero. | |||
| 14-15 | PPLASID | ASID of address space with which I/O requests are associated. | ||
| 14-15 | PPLOFSET | Offset of UCB within DEB for purge by UCB only. PPLUCB is on. | ||