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