Pinging a TSO/E address space using the Interactive ISPF Gateway

To ping a TSO/E address space, send a request to the gateway with the request parameter set to PING. The session to be pinged must be identified using the sessid parameter.

Note: If 15 minutes pass without receipt of a ping for the address space, CEA TSO/E address space services ends the address space.

Using the XML API to ping a TSO/E address space

The following example shows the input and resulting output using the XML API to ping a TSO/E address space:

Input:

<?xml version="1.0"?>                                                          
<ISPF-INPUT>                                                                   
xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"                        
xsi:noNamespaceSchemaLocation=\"ispf.xsd\">                                    
<SERVICE-REQUEST>                                                              
<request>PING</request>                                                        
<sessid>&VER=1&ASID=88&STOKEN=000001600000006C&INDEX=1&MSGQID=3342342&TYPE=TSO</sessid>                                                                      
</SERVICE-REQUEST>                                                             
</ISPF-INPUT>

Output:

<?xml version="1.0"?>                                                   
<ISPF-OUTPUT>                                                           
 <SERVICE-REQUEST>                                                      
<request>PING</request>                                                 
<sessid>&VER=1&ASID=88&STOKEN=000001600000006C&INDEX=1&MSGQID=3342342&TYPE=TSO</sessid>
 </SERVICE-REQUEST>                                                     
 <SERVICE-RESPONSE>                                                     
  <RETURN-CODE>0</RETURN-CODE>                                          
  <SESSION-INFO>                                                        
  <TSOPROMPT>NO</TSOPROMPT>                                             
  </SESSION-INFO>                                                       
 </SERVICE-RESPONSE>                                                    
 <OPERATIONS-LOG>                                                       
 <![CDATA[                                                              
  Content-type: text/plain                                              
                                                                        
  ISPZINL started - z/OS V2R2 01JAN15 Base                              
  Data read from STDIN is
  &REQUEST=PING&VER=1&ASID=88&STOKEN=000001600000006C&INDEX=1&MSGQID=3342342&TYPE=TSO
  *** XML-NOTE *** Reference tagged SERVICE-RESPONSE                    
 ]]>                                                                    
 </OPERATIONS-LOG>                                                      
</ISPF-OUTPUT>

Using the native API to ping a TSO/E address space

The following example shows the input and resulting output using the native API to ping a TSO/E address space:

Input:

&REQUEST=PING &VER=1&ASID=106&STOKEN=000001A80000004E&INDEX=2&MSGQID=9764869&TYPE=ISPF

Output:

Content-type: text/plain                                                
                                                                        
ISPZINL started - z/OS V2R2 01JAN15 Base                                
Data read from STDIN is  &REQUEST=PING 
&VER=1&ASID=106&STOKEN=000001A80000004E&INDEX=2&MSGQID=9764869&TYPE=ISPF
<ISPINFO>                                                               
RC=0                                                                    
</ISPINFO>                                                              
<SESSION-INFO>                                                          
<TSOPROMPT>NO</TSOPROMPT>                                               
</SESSION-INFO>