acmsdi_call_task
task_name
Type: char *
Access: read
Mechanism: by reference
The name of the task to execute. Maximum length is 31.
application_name
Type: char *
Access: read
Mechanism: by reference
The specification of a ACMS application in which the task resides. The
application name must be a valid application specification on the submitter
node. It can take the form NODE::APPLICATION, or can be specified using a
logical name that is translated by the ACMS Central Controller (ACC) on the
submitter node. Maximum length is 80.
selection_string
Type: char *
Access: read
Mechanism: by reference
Used by the desktop client program to pass additional information to the task.
Maximum length is 256.
status_message
Type: char *
Access: write
Mechanism: by reference
A buffer to receive the message text associated with the task completion status.
The message text returned is either the text associated with a TP Desktop
Connector error or the message text returned from a ACMS application.
Required length is 80.
Caution
If the full space is not allocated, the TP Desktop Connector client
services write past the end of the allocated string and can cause the
application to fail. Ensure that the desktop client program allocates
the required length of space.
2–14 TP Desktop Connector Portable API Client Services