Use this system macro with the Multi-Processor Interconnect Facility (MPIF)
support programs to schedule device control functions other than the normal
read or write channel programs generated by MPIF itself.
Required Authorizations
|
Key0
| Restricted
| System
| Common Storage
|
| X
|
|
|
Format
- LEVEL=Dx
- A core block reference word and associated file address reference word
(D0-DF) must be specified.
- SUBREG=sda_reg
- This required parameter specifies the general register (R0 through R6)
which contains the relevant symbolic device address (SDA).
- TYPE
- This required parameter specifies one of the following options of the
MSPIC macro:
- READ
- Read Buffer.
- HDEV
- Deactivate the channel program for the specified SDA pair.
- PRIME
- Prime the specified SDA.
- RELCC
- Release the multiple system request block (MSRB).
- CCW
- Process the user-defined channel program (CCW). CCWs must be Format
1.
- Note:
- This option requires processing of a WAITC macro to very the results, and is
therefore restricted to E-type programs.
- TIMEOUT
- Timeout value for SENSE ID channel program. 0 is the default
value. This parameter must be 0 unless the TYPE parameter is coded as
CCW.
- CLEANUP
- Specify one of the following:
- YES
- Clean-up all resources associated with a path.
- NO
- No cleanup requested.
NO is the default option. YES is only valid when the TYPE parameter
is coded as HDEV.
Entry Requirements
- For the RELCC option, the core block reference word of the specified data
level must contain the address of the MSRB to be released.
- For the CCW option, the core block reference word of the specified data
level must contain the address of the channel program (that is, CCWs) to be
processed.
Return Conditions
- Control is returned to the next sequential instruction (NSI).
- Following the CCW option the contents of the core block reference word at
the specified data level is unchanged.
- R15 contains a return code as follows.
- Return Code
- Meaning
- 00
- Successful processing.
- 00
- A value in the SUBREG register is not valid.
- 08
- Subchannel not attached.
- Following a WAITC, for the CCW option, the following parameters will be
returned on I/O error conditions:
- The error reporting fields in the ECB (CE1SUD, CE1SUG, or CE1SUC) identify
the I/O error.
- The channel status word (CSW) will be contained in the second ECB work
area starting at location CE1WKB.
- The sense data will be contained in the second ECB work area starting at
location CE1WKB+8. 32 bytes are reserved for this sense data
field.
- The contents of all other registers are preserved across this macro
call.
Programming Considerations
- This macro can only be run on the I-stream where MPIF is active.
- The CCW option requires that a WAITC macro be issued following the MSPIC
macro processing. This restricts the use of the CCW option to E-type
programs only.
Examples
None.