Me_AqCInitReq

NAME: Me_AqCInitReq - SET Me_AqCInitReq message data structures and routines

SYNOPSIS

#include <set_msg.h>

typedef struct Me_AqCInitReq_ {
    asn1set__MessageWrapper    messageWrapper;
} *Me_AqCInitReq;

Me_AqCInitReq safe_cast_Me_AqCInitReq(msg)
    set_msg            msg;             /* IN */

DESCRIPTION: Me_AqCInitReq contains the data from a SET Me_AqCInitReq message in native C form. See the asn_types.h and asn1set.h header files for the declarations of the various types. See the SET specification for a description of individual fields.
Me_AqCInitReq message objects of type set_msg may be cast to type Me_AqCInitReq using the safe_cast_Me_AqCInitReq() routine.

FIELDS

Before calling make_set_msg(), software must insert the following state into the cache_ctx:

*      STATE_LOCALID_EE

A call to make_set_msg() results in the protocol layer filling in the following fields:

 *    messageWrapper.messageHeader.version
 *    messageWrapper.messageHeader.date
 *    messageWrapper.messageHeader.rrPID
 *    messageWrapper.messageHeader.swIdent
 *    messageWrapper.message._choice
 *    messageWrapper.message.u.me_AqCInitReq.rrpid
 *    messageWrapper.message.u.me_AqCInitReq.localID_EE
 *    messageWrapper.message.u.me_AqCInitReq.chall_EE
 *    messageWrapper.message.u.me_AqCInitReq.thumbs (optional)

It is unwise for users to change the contents of the fields filled in by the protocol layer.

After calling make_set_msg(), software must fill in the following required fields:

 *    messageWrapper.message.u.me_AqCInitReq.requestType
 *    messageWrapper.message.u.me_AqCInitReq.idData
 *    messageWrapper.message.u.me_AqCInitReq.brandID
 *    messageWrapper.message.u.me_AqCInitReq.language

Non-required fields may be left empty at the discretion of the application, subject to any business constraints placed on the application.

CACHING

Certification Authority

      STATE_CHALL_EE                 put
      STATE_LOCALID_EE               put
      STATE_ME_AQCINITREQ_RRPID      put
      STATE_REQUESTTYPE              put
      STATE_THUMBS                   put

Merchant, Payment Gateway

      STATE_CHALL_EE                 put
      STATE_LOCALID_EE               get
      STATE_ME_AQCINITREQ_RRPID      put
      STATE_REQUESTTYPE              put
      STATE_THUMBS                   put

RETURN VALUES: On success, safe_cast_Me_AqCInitReq() returns a pointer to an Me_AqCInitReq data structure. Objects of type set_msg that were not created with message type asn1set__Message__me_AqCInitReq will cause safe_cast_Me_AqCInitReq() to fail. On failure, safe_cast_Me_AqCInitReq() returns a null pointer.

SEE ALSO: set_msg

NOTES: There is a difference between non-required and optional. Non-required fields may be omitted according to the SET protocol. Optional fields may be omitted according to ASN.1 encoding rules. In some messages, a field may be optional according to ASN.1, but still required by the SET protocol. In these cases, the application must fill in these fields.
Optional fields that are filled in require an application of the SET_PRESENT() macro. See documentation on ASN.1/DER runtime types for additional information.

EXAMPLE

A more complete, explicated example is provided in the Implementor's Guide.

    msg_type = asn1set__Message__me_AqCInitReq;
    status = make_set_msg(request, app_ctx, &msg_cache[0], msg_type);
    assert(status == NO_ERROR);

    me_AqCInitReq = safe_cast_Me_AqCInitReq(request);
    assert(me_AqCInitReq != 0);

    me_AqCInitReq->messageWrapper.message.u.me_AqCInitReq.language =
                ENGLISH;

    me_AqCInitReq->messageWrapper.message.u.me_AqCInitReq.brandID.u.
                visibleString = BRANDID;
    me_AqCInitReq->messageWrapper.message.u.me_AqCInitReq.brandID._choice =
                asn1set__BrandID__visibleString;
    me_AqCInitReq->messageWrapper.message.u.me_AqCInitReq.requestType = 
                CERT_REQ_TYPE;

    me_AqCInitReq->messageWrapper.message.u.me_AqCInitReq.idData.u.
                merchantAcquirerID.merchantBIN = MERCHANTBIN;

    me_AqCInitReq->messageWrapper.message.u.me_AqCInitReq.idData.u.
                merchantAcquirerID.merchantID.u.visibleString =
                MERCHANTID;
    me_AqCInitReq->messageWrapper.message.u.me_AqCInitReq.idData.u.
                merchantAcquirerID.merchantID._choice =
                asn1set__MerchantID__visibleString;

    me_AqCInitReq->messageWrapper.message.u.me_AqCInitReq.idData._choice =
                asn1set__IDData__merchantAcquirerID;


    status = send_set_msg(request, app_ctx, &msg_cache[0], outstream);
    assert(status == NO_ERROR);

BUGS: This document describes a beta implementation. The information contained in this document may be incomplete and is subject to change.