z/OS MVS Programming: Callable Services for High-Level Languages
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


CeaTsoPing - Sending a ping on behalf of an application

z/OS MVS Programming: Callable Services for High-Level Languages
SA23-1377-02

Each TSO/E session has an idle application time that the CEA TSO/E address space manager uses to determine if the application that is associated with the session is active. If the idle application time is 15 minutes, the application is considered to be inactive. In which case, the CEA TSO/E address space manager ends all the CEA-managed TSO/E sessions for that application that have the same application identifier.

To prevent TSO/E sessions from ending because of idle application time, callers can use the CeaTsoPing request type to issue a ping request at least once every 15 minutes. Doing so informs CEA that the application is still active, and causes the CEA TSO/E address space manager to reset the idle application time for all the CEA-managed TSO/E sessions that have the same application identifier.

To perform this request, the CEA TSO/E address space manager extracts the caller’s security UTOKEN from the caller’s environment and uses it when needed.

Table 1 lists the input callers must provide for each structure used for this request type and the output that will be provided. No other fields in the structures are used. The value for the unused fields is indeterminate. For more details about the fields listed for each structure, see Parameters.

Table 1. Input and output for each structure used for the CeaTsoPing request type
Structure Required Input Output
CeaTsoRequestStruct
  • eyecatcher
  • ceatso_version
  • ceatso_requesttype
  • ceatso_asid
  • ceatso_apptag
  • ceatso_stoken
  • ceatso_index
None
CeaTsoQueryStruct Not used for this request type. Not used for this request type.
CeaTsoErrorStruct
  • eyeCatcher
  • version
  • returnCode
  • reasonCode
  • diag

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014