DELETE_MODE

The DELETE_MODE verb requests deletion of a mode definition. Default definitions for CPSVCMG, SNASVCMG, and other standard SNA modes will not be deleted.

VCB Structure

typedef struct delete_mode
{
        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   mode_name[8];   /* mode name             */
} DELETE_MODE;

Supplied Parameters

The application supplies the following parameters:

opcode: AP_DELETE_MODE
format: Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
mode_name: Name of the mode. This is an 8-byte alphanumeric type-A EBCDIC string (starting with a letter), padded to the right with EBCDIC spaces.

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_CP_OR_SNA_SVCMG_UNDELETABLE
AP_MODE_UNDELETABLE
AP_DEL_MODE_DEFAULT_SPCD
AP_MODE_NAME_NOT_DEFD

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