Using Host Services-Supported Task Attributes

Host Services supports task attributes in four ways:

  • Supported attributes set in the task variable before the remote task is initiated are passed to the remote task for its initiation.

  • Supported attributes set in the initiating program while the remote program is running are copied to the remote task immediately.

  • Supported attributes that are inquired on in the initiating program while the remote program is running are fetched from the remote task immediately.

  • When the remote task terminates, the following attributes are copied back to the task variable in the local program:

    ACCUMIOTIME

    ACCUMPROCTIME

    CHARGE

    DATAPATH

    ELAPSEDTIME

    EXECUTEPATH

    FAMILY

    HISTORYCAUSE

    HISTORYREASON

    HISTORYTYPE

    MIXNUMBER

    OPTION

    PDUMPTITLE

    READYQTIME

    STACKHISTORY

    STATION

    STATUS

    STOPPOINT

    SW1

    SW2

    SW3

    SW4

    SW5

    SW6

    SW7

    SW8

    TASKVALUE

     

Supported task attributes are only copied back to the initiating program either when they are interrogated by the initiating program or when they are in the preceding list and the remote program terminates.

Host Services supports the majority of the task attributes discussed in this guide. However, some task attributes cannot be used across multihost networks. If Host Services does not support a task attribute, then that attribute cannot be accessed by a process running on a different host system. For example, if a parent process is running on one system and its task is running on another system, the parent cannot access some of the task attributes of the task.

To determine whether a particular task attribute is supported by Host Services, refer to the description of that attribute.

Generally, if Host Services does not support a task attribute, then any attempt to access the attribute through Host Services is ignored. No error results, but the task attribute remains unchanged. A warning message is displayed if the DSSSUPPORT library on the system was compiled with the DIAGNOSTICS option set. However, if a process attempts to access the ACCEPTEVENT, EXCEPTIONEVENT, or TASKFILE task attribute of another process across a multihost network, the accessing process is discontinued.

Hosts running different software release levels can be linked in the same network. When accessing the task attributes of a remote task, the remote host may be running an old version of Host Services that does not support all the task attributes that the current version of Host Services does.