The UNACCESS function ends the connection between the application program and OAM. When the calling program no longer requires OSREQ services, it must issue OSREQ UNACCESS. When invoking UNACCESS, the caller supplies an eight-byte token that has been set by a successful issuance of OSREQ ACCESS. UNACCESS should not be requested unless the corresponding ACCESS was successful. An initialized token is required by all OSREQ calls, except ACCESS. The syntax diagram for the OSREQ UNACCESS function follows.

Syntax for OSREQ UNACCESS

>>-OSREQ UNACCESS--MF=-+-L---------------------------------+---->
                       +-(M,parameter_list-+-----------+-)-+   
                       |                   '-,COMPLETE-'   |   
                       '-(E,parameter_list-+-----------+-)-'   
                                           '-,COMPLETE-'       

>--+-------------------------------------+---------------------->
   |       (1)                           |   
   '-TOKEN----=-+-token_area-----------+-'   
                '-(token_area_pointer)-'     

>--+-------------------------------------+---------------------->
   '-MSGAREA=-+-message_area-----------+-'   
              '-(message_area_pointer)-'     

>--+------------------------------------+----------------------->
   '-RETCODE=-+-return_code-----------+-'   
              '-(return_code_pointer)-'     

>--+------------------------------------+----------------------->
   '-REACODE=-+-reason_code-----------+-'   
              '-(reason_code_pointer)-'     

>--+--------------------------------------+--------------------><
   '-TTOKEN=-+-tracking_token-----------+-'   
             '-(tracking_token_pointer)-'     

1. This keyword must be specified on at least one of the forms if the MF=E does not indicate COMPLETE.

OSREQ UNACCESS does not attempt to end any active requests that are using the same token, but returns control to the UNACCESS caller with a warning return code and reason code. When each of the outstanding requests completes, any further OSREQ requests using that token receive return and reason codes indicating that the token is no longer valid.