UNPOST STRUCTURE(3P) — SUNPHIGS LIBRARY

NAME

UNPOST STRUCTURE − unpost a structure from the specified workstation

SYNOPSIS

C Syntax

void
punpoststruct ( ws, struct_id )
Pintws;workstation identifier
Pintstruct_id;structure identifier

FORTRAN Syntax

SUBROUTINE pupost ( WKID, STRID )
INTEGERWKIDworkstation identifier
INTEGERSTRIDstructure 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, 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

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

struct_id
The identifier of the structure to be unposted.

FORTRAN Input Parameters

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

STRID
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 Central Structure Store and may again be posted to the same or another workstation. Other workstations are unaffected.

If struct_id is not listed in the table of posted structures or does not exist in the Central Structure Store 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)

Museum