DELETE_PORT

DELETE_PORT deletes all link stations and connection network transmission groups (TGs) associated with the port if it is reset. It then deletes the port's control block, frees the memory, and returns a response from the Node Operator Facility indicating whether the port has been deleted successfully.

Note that if a link station, which has a PU associated with it, is deleted (because it is associated with the port) then any LUs defined on this PU will also be deleted.

VCB Structure

typedef struct delete_port
{
        unsigned short  opcode;         /* verb operation code   */
        unsigned char   attributes;     /* verb attributes       */
        unsigned char   format;         /* format                */
        unsigned short  primary_rc;     /* primary return code   */
        unsigned long   secondary_rc;   /* secondary return code */
        unsigned char   port_name[8];   /* name of port          */
} DELETE_PORT;

Supplied Parameters

The application supplies the following parameters:

opcode: AP_DELETE_PORT
attributes: The attributes of the verb. This field is a bit field. The first bit contains the visibility of the resource to be defined and corresponds to one of the following:
AP_EXTERNALLY_VISIBLE
AP_INTERNALLY_VISIBLE
format: Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
port_name: Name of port being deleted. This is an 8-byte string in a locally displayable character set. All 8 bytes are significant and must be set.

Returned Parameters

If the verb executes successfully, the Program returns the following parameter:

primary_rc: AP_OK

If the verb does not execute because of a parameter error, the Program returns the following parameters:

primary_rc: AP_PARAMETER_CHECK
secondary_rc: AP_INVALID_PORT_NAME

If the verb does not execute because of a state error, the Program returns the following parameters:

primary_rc: AP_STATE_CHECK
secondary_rc: AP_PORT_ACTIVE

If the verb does not execute because the node has not yet been started, the Program returns the following parameter:

primary_rc: AP_NODE_NOT_STARTED

If the verb does not execute because the node is stopping, the Program returns the following parameter:

primary_rc: AP_NODE_STOPPING

If the verb does not execute because of a system error, the Program returns the following parameter:

primary_rc: AP_UNEXPECTED_SYSTEM_ERROR