GPDTR - Detach Resource

Purpose

Use GPDTR to detach a resource from your application. The resource becomes unavailable to your application.

The id parameter specifies an identifier that your application assigned to the resource. The type parameter is used to identify the type of resource that is specified by the id parameter. For example, if the type parameter specifies 1=WORKSTATION , then the id parameter is used to specify a workstation identifier (wsid) to be detached.

If the specified resource type is 1=WORKSTATION all events from the specified workstation are removed from the event queue. If the specified workstation is the last open workstation, the workstation state value is set to Workstation Closed (WSCL)

If the specified resource type is 2=STRUCTURE_STORE all events from the specified structure store are removed from the event queue. If the current structure state is Structure Open (STOP) and the specified structure store is currently selected, then the current open structure is closed. As a result, the structure state is set to Structure Closed (STCL) If the current structure state is Structure Closed (STCL) and the specified structure store is the currently selected structure store, it is removed from the currently selected structure store entry of the graPHIGS API state list. As a result, the structure state is set to Structure Store Open (SSOP) If the specified structure store is the last structure store attached to the shell, then the structure state is set to Structure Store Closed (SSCL)

If the specified resource type is 5=ARCHIVE_FILE and if the specified archive file is the last open archive file, then the archive state value is set to Archive Closed (ARCL)

Parameters