PCB call (CICS online programs only)

The PCB call is used to schedule a PSB call.

The ODBA interface does not support this call.

Format

Read syntax diagramSkip visual syntax diagramPCBpsb nameuibptrsysserve
Call Name DB/DC DBCTL DCCTL DB Batch TM Batch
PCB X X      

Parameters

The AIB is not valid for PCB calls.
psb name
Specifies the PSB. An asterisk can be used for the parameter to indicate the default. This parameter is an input parameter.
uibptr
Specifies a pointer, which is set to the address of the UIB after the call. This parameter is an output parameter.
sysserve
Specifies an optional 8-byte field that contains either IOPCB or NOIOPCB. This parameter is an input parameter.

Usage

Before a CICS® online program can issue any DL/I calls, it must indicate to DL/I its intent to use a particular PSB. A PCB call accomplishes this and also obtains the address of the PCB list in the PSB. When you issue a PCB call, specify:

  • The call function: PCBb
  • The PSB you want to use, or an asterisk to indicate that you want to use the default name. The default PSB name is not necessarily the name of the program issuing the PCB call, because that program could have been called by another program.
  • A pointer, which is set to the address of the UIB after the call.

    For more information on defining and establishing addressability to the UIB, see the topic "Specifying the UIB (CICS Online Programs Only)" in IMS Version 15 Application Programming.

  • The system service call parameter that names an optional 8-byte field that contains either IOPCB or NOIOPCB.

Restrictions

For function shipping in the CICS environment, the local and remote CICS must both be DBCTL.