CONV_SECURITY_BYPASS

CONV_SECURITY_BYPASS allows an application to control whether the Program will enforce conversation-level security for a local LU. Once security has been bypassed, the Program will not do any authentication or authorization for the conversations on the local LU.

VCB Structure

typedef struct conv_security_bypass
{
   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   lu_name[8];       /* local LU name              */
   unsigned char   lu_alias[8];      /* local LU alias             */
   unsigned char   bypass_security;  /* should security be         */
                                     /* bypassed?                  */
   unsigned char   reserv3[3];       /* reserved                   */
} CONV_SECURITY_BYPASS;

Supplied Parameters

The application supplies the following parameters:
opcode
AP_CONV_SECURITY_BYPASS
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
lu_name
LU name of the local LU. This name is an 8-byte type-A EBCDIC character string. If this field is set to all zeros, the lu_alias field will be used for determining the local LU.
lu_alias
Local LU alias. This is an 8-byte string in a locally displayable character set. This field is only significant if the lu_name field is set to all zeros, in which case all 8 bytes are significant and must be set. If both the lu_alias and the lu_name are set to all zeros, the verb is forwarded to the LU associated with the control point (the default LU).
bypass_security
Specifies whether security should be bypassed (AP_YES or AP_NO).

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_LU_NAME

AP_INVALID_LU_ALIAS
AP_INVALID_BYPASS_SECURITY

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