acmsdi_call_task
workspace_count
Type: long int
Access: read
Mechanism: by value
The decimal number of workspaces being passed to the task.
workspaces
Type: ACMSDI_WORKSPACE or ACMSDI_WORKSPACE_OPT array
Access: read/write
Mechanism: by reference
One or more optional workspaces to be passed to the task. You need to typecast
your array to void *. The workspaces must be specified in the same order as
they are declared in the task definition, and must match the number specified
in the workspace_count parameter. If you use the ACMSDI_WORKSPACE_
OPT type, you must set the call_options parameter to allow unidirectional
workspaces.
call_id
Type: ACMSDI_CALL_ID
Access: write
Mechanism: by reference
A structure defined in the ACMSDI.H include file into which the acmsdi_call_
task service writes a newly created call identification, a handle used by the TP
Desktop Connector client services to identify an active call for a submitter.
completion_status
Type: int
Access: write
Mechanism: by reference
The final status of the TP Desktop Connector client service. In the blocking
environment, the completion_status parameter is set to zero when the service
starts successfully.
When the service completes, the completion_status parameter contains the final
status. See Table 2–2 for the list of return status values.
When a task is canceled, the TP Desktop Connector gateway reports a specific
error, where possible. If the gateway cannot convert a ACMS error to a specific
TP Desktop Connector status, it returns ACMSDI_TASK_FAILED to the
desktop client program.
TP Desktop Connector Portable API Client Services 2–15