Successful API Call

For asynchronous APIs, the Exit record merely indicates whether the call was acceptable. The contents of general-purpose register 15 are displayed to indicate this. The Asynchronous Complete record shows the actual results of the call. In addition to the output parameters, several interesting values are traced, including the contents of general-purpose register 0, the pointer to the asynchronous exit routine, the token passed to the asynchronous exit, the key in which the asynchronous exit was invoked, and the authorization state in which the exit is invoked. These values are not parameters on the GETHOSTID call, so their addresses are not shown. In this example, note also that the return code is formatted in dotted decimal and the meaning of the return code is provided.

Note: The API call might complete synchronously, in which case the Async Complete trace record might appear in the trace prior to the Exit record.

====================================================================00007B01   
 MVS026    SOCKAPI   60050012  19:27:08.111729   GETHOSTID Exit                
HASID....0027     PASID....0027     SASID..0027     JOBNAME..EZASOKOS          
TCB......006E6A68 TIE......00006DF8 PLIST..00006E0C DUCB.....0000000C KEY..8 
ADSNAME..EZASOKOS SUBTASK..00000000 00000000        TOKEN....7F6F3798 09902FB0 
 REQAREA..:  00006D90x                                          Addr..00006D90 
 R15......:  0 (CALL ACCEPTED)                                                 
====================================================================00007B05   
 MVS026    SOCKAPI   60050032  19:27:08.111741   GETHOSTID Async Complete      
HASID....0027     PASID....0027     SASID..0027     JOBNAME..EZASOKOS          
TCB......006E6A68 TIE......00006DF8 PLIST..00006E0C DUCB.....0000000C KEY..8  
ADSNAME..EZASOKOS SUBTASK..00000000 00000000        TOKEN....7F6F3798 09902FB0 
 REQAREA..:  00006D90x                                          Addr..00006D90 
 R0.......:  0x (NORMAL RETURN)                                                
 ASYNC PTR:  00006B1C                                                          
 EXIT TOKEN: 00006B98x                                                         
 EXIT KEY.:  8x                                                               
 AUTHORIZATION STATE: PROBLEM                                                  
 RETCODE..:  9.67.113.58     (HOST IP ADDRESS)                  Addr..00006EB4