Execute Channel Program


In IBM mainframe operating systems, Execute Channel Program is a supervisor call for low-level device access, where the programmer is responsible for providing a channel program—a list of device-specific commands —to be executed by I/O channels, control units and devices. EXCP for OS/360 and successors is more specifically described in the OS System Programmer's Guide.; EXCP for DOS/360 and successors is more specifically described in DOS Supervisor and I/O Macros.
This article mostly reflects OS/360 through ; some details are different for TOS/360 and DOS/360 through z/VSE.

Specifying datasets

Using EXCP, legacy devices and legacy datasets may be operated on with relatively high performance. EXCP devices are OPENed by specifying the Data Control Block for OS and the DTFPH for DOS.

Exits (Appendages)

A comprehensive list of "exits" allows authorized programs to override or augment many of the system security and data integrity checks. Most of these appendages are supported for compatibility with earlier instances of the OS, but the functions of several have been modified or extended for MVS. The appendages are specified in the DCB as the last two characters of the module name IGG019xx. where xx = WA to Z9 inclusive. These module names are reserved for installation-written appendages. Any other name of the form IGG019xx is reserved for use by IBM access methods. Appendages must reside in SYS1.SVCLIB.

Dataset integrity

Normally, when a device is OPENed for EXCP, only the first "extent" is represented in the Data Extent Block. Among other information each DEB contains information on the location and size of each extent of the data set.. If, for example, the programmer tries to read past the end of an extent, an exception occurs and the operation is suppressed, thereby preventing a data integrity exposure. Should the DEB include additional extents, the channel program may be updated by the programmer to refer to the next extent and the EXCP may be reissued, or the end of extent exit appendage, if provided, may update the channel program to the next extent and the operation may be re-driven without first going through the EXCP processor.

Legacy datasets only

EXCP is sometimes confused with a direct access storage device access method, but it is not for direct access storage devices exclusively; rather, it is a general purpose low-level device access interface which supports any legacy device type and any legacy dataset organization. For accessing all device types and all dataset organizations, the more general Start Input/Output interface is available in MVS/370 and subsequent instances of the OS although it is not an officially supported interface.

Simplified operations on direct access datasets

A variation of EXCP is Execute Direct Access Program, which is used for accessing direct access storage only, and is provided for reading and updating existing direct access storage records. XDAP cannot be used to add records, but XDAP can be utilized along with BSAM or BPAM to effect record additions to such datasets, and several OS components utilize XDAP in this manner.

Telecommunications device access

EXCP may also be used to access communications devices attached to IBM 2701, 2702 and 2703 communications controllers and IBM 370x or Amdahl 470x front-end processors operating in emulator mode or partitioned emulator mode.

Relationship to supervisor

EXCP's front-end is always in TCB mode, as EXCP is a Type 1 SVC. In MVS/370 and subsequent instances of the OS, the EXCP processor invokes STARTIO to schedule execution of the channel program. Although the EXCP processor's back-end is always in SRB mode, the back-end contains emulation code which allows the appendages developed for earlier, pre-MVS instances of the OS, specifically for EXCP, to function largely as before and thereby to appear to be in TCB mode, for which these appendages were originally designed. This distinction can complicate conversion of certain "roll-your-own" access methods and applications to MVS.

Channel programs

System/360 channel programs are a sequence of commands which are executed by the channel and the I/O device. Channel programs can be located anywhere in main storage. The channel program is a sequence of Channel Command Words, which may be executed sequentially unless a branch, called "Transfer In Channel", is executed, or the channel returns a status modifier. Each CCW is a doubleword as follows:

bit 0 7 8 31
+--------+-----------------------+
|Command | Data address |
+--------+-----------------------+
32 36 40 47 48 63
+------+---+--------+------------+
|Flags |000|reserved| count |
+------+---+--------+------------+
Six commands are defined, in the low-order bits of the command field. The high-order four bits are modifiers for some commands, or are ignored. The commands are:
0100 - Sense
1000 - Transfer in Channel
1100 - Read backward
--01 - Write
--10 - Read
--11 - Control

The data address is the 24-bit address of a main storage buffer area to or from which the data is to be transferred.
The flag bits are defined as follows:
BitIDNameDescription
32CDChain dataUse the storage area specified in the next CCW to continue this command
33CCChain commandExecute the next sequential CCW when this command completes
if CC or CD are not set, the channel program terminates after executing this command
34SLISuppress length indicationIgnore incorrect length for this command
35SKIPSkipSuppress data transfer for this command
36PCIProgram controlled interruptionGenerate an interrupt when this command starts executing

The count field indicate the number of bytes to be transferred by this command.
All eight bits of commands that initiate I/O operations are passed to the device. "The modifier bits specify to the device how the command is to be executed." For example, for the IBM 2305 DASD the write command may have the following values:
Bit valueHexadecimalDescription
0001 1001'19'XWrite home address
0001 0101'15'XWrite record 0
0001 0001'11'XErase
0001 1101'1D'XWrite count, key, and data
0000 0001'01'XWrite special count, key, and data
0000 0101'05'XWrite data
0000 1101'0D'XWrite key and data