CPI-C support provided by IBM Z Workload Scheduler

Your ATPs can issue requests to IBM Z Workload Scheduler through the API using CPI-C. Although your programs can use any CPI-C verbs, you should consider this information before you write your programs. It describes how the partner TP, IBM Z Workload Scheduler, responds to certain verbs:

CMACCP

Accept_Conversation

CMACCP is not applicable because the ATP must initialize and allocate the conversation.

CMALLC

Allocate

CMALLC must be issued by the ATP to allocate the conversation.

CMCFMD

Confirmed

CMCFMD is returned by IBM Z Workload Scheduler when a confirm verb is issued by the ATP. But IBM Z Workload Scheduler does not perform additional processing for a confirm request. The confirmed verb is issued when the request is received.

CMINIT

Initialize_Conversation

CMINIT must be issued by the ATP to initialize the conversation.

CMRCV

Receive

The ATP should repeat CMRCV calls to ensure that it receives the requested data. This is because when IBM Z Workload Scheduler receives the send state from the ATP and has no data to send at that time, it issues a receive inviting the ATP to send more requests. So the ATP determines the frequency of the polling.

CMSED

Set_Error_Direction

CMSED can be issued but is not used by IBM Z Workload Scheduler.

CMSERR

Send_Error

CMSERR can be issued but is not used by IBM Z Workload Scheduler.

CMSLD

Set_Log_Data

CMSLD can be issued but is not used by IBM Z Workload Scheduler.

CMSTPN

Set_TP_Name

Specify TP name EQQAPI, which is the default name. IBM Z Workload Scheduler recognizes these TP names:

EQQTRK: Supplied by trackers that communicate with the Z controller through APPC
EQQAPI: Supplied by user programs (ATPs) that communicate with IBM Z Workload Scheduler through the API.