DELETE_ADJACENT_NODE

DELETE_ADJACENT_NODE removes entries in the node directory database that are associated with the resources on an adjacent node.

To remove the node's control point from the directory along with its LUs, set num_of_lus to zero. If num_of_lus is nonzero, this verb is used to remove node LUs from the directory, leaving the control point definition intact.

If the verb fails for any reason, no directory entries will be deleted.

VCB Structure

The DELETE_ADJACENT_NODE verb contains a variable number of ADJACENT_NODE_LU overlays. The ADJACENT_NODE_LU structures are concatenated onto the end of DELETE_ADJACENT_NODE structure.
typedef struct delete_adjacent_node
{
        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   cp_name[17];     /* CP name                    */
        unsigned short  num_of_lus;      /* number of LUs              */
} DELETE_ADJACENT_NODE;
typedef struct adjacent_node_lu
{
        unsigned char   wildcard_lu;     /* wildcard LU name indicator */
        unsigned char   fqlu_name[17];   /* fully qualified LU name    */
        unsigned char   reserv1[6];      /* reserved                   */
} ADJACENT_NODE_LU;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_DELETE_ADJACENT_NODE
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
cp_name
The fully qualified name of the control point in the adjacent LEN end node. The name is 17 bytes long and is right-padded with EBCDIC spaces. It is composed of two type-A EBCDIC character strings concatenated by an EBCDIC dot. (Each name can have a maximum length of 8 bytes with no embedded spaces.)
num_of_lus
The number of LUs to be deleted. Set this to zero if the entire node definition is to be deleted. This number represents the number of adjacent LU overlays that follow the DELETE_ADJACENT_NODE VCB.
adjacent_node_lu.wildcard_lu
Indicates whether the specified LU name is a wildcard name (AP_YES or AP_NO).
adjacent_node_lu.fqlu_name
The LU name to be deleted. If this name is not fully qualified, the network ID of the CP name is assumed. The name is 17 bytes long and is right-padded with EBCDIC spaces. It is composed of one or two type-A EBCDIC character strings concatenated by an EBCDIC dot. (Each name can have a maximum length of 8 bytes with no embedded 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_INVALID_CP_NAME

AP_INVALID_LU_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_INVALID_CP_NAME

AP_INVALID_LU_NAME

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