HP 3000 Manuals

HPDTerminate [ HP DeskManager Intrinsics ] MPE/iX 5.0 Documentation


HP DeskManager Intrinsics

HPDTerminate 
_____________________________________
|                                   |
|                     S             |
|     HPDTerminate (status);        |
_____________________________________

            

HPDTerminate allows an application to sign off as the HP Desk user or
gateway, to shut down or make a user available to other applications.

status 

Required, by Reference; type = STATUS_TYPE

Used to return information from the Intrinsic.

This gives the overall result of the operation.  It does not matter what
it contains when the Intrinsic is called.

General Information about HPDTerminate 

HPDTerminate allows an application to sign off from the current user or
gateway specified in the last call to HPDUserSignon or HPDGateSignon.  It
need not be called before a call to the sign on Intrinsics as this
results in automatic logging off from the first user or gateway.
However, if an application does not call HPDTerminate before it
terminates, the signed on user appears to HP Desk as being signed on
until the job or session running the application signs on to that user
again, or logs off with a BYE, :EOJ or :EOF.


NOTE It is advisable for user applications to call HPDTerminate before closing down as HPDTerminate deletes files and generally "tidies up" after an Intrinsics session. In particular, failure to call HPDTerminate will mean files named HPDI.... and HPDO.... will be left in the MPE permanent and temporary file domains.
Status Returns Specific to HPDTerminate -400 Cannot access first parameter -500 Application does not have PH capability -501 Application does not have DS capability -502 User does not have SF capability -1002 Application is not signed on as a user or gateway -1003 HP Desk is not available -1900 Unexpected error


MPE/iX 5.0 Documentation