START_PORT

START_PORT requests the activation of a port. It is returned indicating whether the port was successfully activated. The port can be started even if no link stations have been defined for it, but it will not be started if its parent DLC is inactive.

See DLC Processes, Ports, and Link Stations for more information about the relationship between DLCs, ports and link stations.

VCB Structure

typedef struct start_port
{
        unsigned short  opcode;         /* verb operation code   */
        unsigned char   reserv2;        /* reserved              */
        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          */
} START_PORT;

Supplied Parameters

The application supplies the following parameters:

opcode: AP_START_PORT
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 to be started. This is an 8-byte string in a locally displayable character set and must match that on the DEFINE_PORT verb.

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_DLC_INACTIVE
AP_STOP_PORT_PENDING
AP_DUPLICATE_PORT

If the verb does not execute because it was canceled, the Program returns the following parameter:

primary_rc: AP_CANCELLED

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