NAME

UNPOST STRUCTURE − unpost a structure from the specified workstation

SYNOPSIS

C Syntax

void
punpost_struct ( ws_id, struct_id )
Pintws_id;workstation identifier
Pintstruct_id;structure identifier

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

UNPOST STRUCTURE unposts a single structure from a workstation.  The structure is not deleted from the Central Structure Store (CSS), but it is no longer eligible for display on the workstation. 

The immediate effect of the function on the display surface will depend on the workstation’s display update state. 

C Input Parameters

ws_idThe structure is to be unposted from the workstation with this identifier. 

struct_id
The identifier of the structure to be unposted.

Execution

UNPOST STRUCTURE removes the structure specified from the table of posted structures on the workstation.  Unless the structure is part of a structure network posted to the workstation, the structure is no longer eligible for display on the workstation, and changes to the structure will no longer affect the workstation. 

The structure is not deleted from the CSS and may again be posted to the same or another workstation.  Other workstations are unaffected. 

If structure identifier is not listed in the table of posted structures or does not exist in the CSS when UNPOST STRUCTURE is called, the function takes no action. 

The effect of unposting the structure may be immediately visible on the workstation’s display, depending on the workstation’s display update state. 

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

SEE ALSO

POST STRUCTURE (3P)
INQUIRE POSTED STRUCTURES (3P)
INQUIRE SET OF WORKSTATIONS TO WHICH POSTED (3P)
UNPOST ALL STRUCTURES (3P)

September 02, 1992