SCHD command

The Schedule (SCHD) command is used to schedule a PSB in a CICS® online program.

For information on the I/O PCB, see the topic "PCBs and PSB" in IMS Version 15 Application Programming.

Format

Read syntax diagramSkip visual syntax diagramEXECDLISCHEDULESCHDPSB( name)PSB(( area))SYSSERVENODHABEND

Options

PSB(name)
Specifies the name of the PSB available to your application program that you want to schedule with the SCHD command.
PSB((area))
Specifies an 8-byte data area in your program that contains the name of the PSB available to your program that you want to schedule with the SCHD command.
SYSSERVE
Specifies that the application program can handle an I/O PCB and might issue a system service request in the logical unit of work (LUW).
NODHABEND
Specifies that a CICS transaction does not fail with a DHxx abend.

Should a schedule fail under EXEC DLI, a status code might be returned in the DIB, causing a CICS transaction to fail with a DHxx abend. This option prevents this. Following an unsuccessful SCHD command, the control, as well as the status code in the DIB are passed back to the application program, which can then take the appropriate action.

Usage

Before you can access DL/I databases from a CICS program, you must notify DL/I that your program will be accessing a database by scheduling a PSB. Do this by issuing the SCHD command. When you no longer plan to use a PSB, or you want to schedule a subsequent PSB (one or more), you must terminate the previous PSB with the TERM command. (For more information on the I/O PCB and PSB, see the topic "PCBs and PSB" in IMS Version 15 Application Programming)

The SCHD command can be specified two ways, as shown by the following code examples.

Example

EXEC DLI SCHD PSB(psbname)SYSSERVE;
EXEC DLI SCHD PSB((AREA));
Explanation

These examples show two ways to schedule a PSB in a CICS program.