3.5.1 VCB Structure

typedef struct send_mds_mu
{
   AP_UINT16       opcode;                 /* Verb operation code                  */
   unsigned char   reserv2;                /* reserved                             */
   unsigned char   format;                 /* reserved                             */
   AP_UINT16       primary_rc;             /* Primary return code                  */
   AP_UINT32       secondary_rc;           /* Secondary return code                */
   unsigned char   options;                /* Verb options                         */
   unsigned char   reserv3;                /* reserved                             */
   unsigned char   originator_id[8];       /* Originator ID                        */
   unsigned char   pu_name[8];             /* Physical unit name                   */
   unsigned char   reserv4[4];             /* reserved                             */
   AP_UINT16       dlen;                   /* Length of data                       */
   unsigned char   *dptr;                  /* Data                                 */
} SEND_MDS_MU; 

3.5.2 Supplied Parameters

An application supplies the following parameters when it issues SEND_MDS_MU:

opcode

AP_SEND_MDS_MU

options

This parameter is a one-byte value, with individual bits used as follows to indicate the options selected. Bit 0 is the most significant and bit 7 is the least significant bit. For compatibility with other implementations, the bit values for bits 0-3 are defined so that a value of 1 indicates no action and a value of 0 indicates an action.

Bit 0

Add Date/Time subvector to the data. Set this bit to one of the following values:

0

Requests that SNAP-IX add the subvector

1

Requests that SNAP-IX not add the subvector

Bit 1

Add Product Set ID subvector to the data. Set this bit to one of the following:

0

Requests that SNAP-IX add the subvector. If the application supplies data that already contains a Product Set ID subvector, SNAP-IX adds its own Product Set ID subvector immediately preceding the existing one.

1

Requests that SNAP-IX not add the subvector.

Bit 2

Reserved. Must be set to 0.

Bit 3

Log the data in the SNAP-IX error log file. Set this bit to one of the following:

0

Requests that SNAP-IX log the data.

1

Requests that SNAP-IX not log the data.

Bit 4

Specifies whether MS is to use default or direct routing to send the MS data to the destination application. Set this bit to one of the following:

0

Requests that SNAP-IX use default routing. Specify default routing unless the application has received an FP_NOTIFICATION indication that describes the destination application and has the fp_routing parameter set to AP_DIRECT. For more information, see FP_NOTIFICATION.

1

Requests that SNAP-IX use direct routing.

Bits 5-7

Reserved. Must be set to 0.

originator_id

Name of the component that issued the verb. If the data is being logged in the SNAP-IX error log file, this name is used to identify the originator of the log message; otherwise, it is not used.

This optional parameter is an ASCII string of up to eight characters, using any locally displayable characters. Set the first character to 0x00 if you do not want to include it.

pu_name

Destination physical unit for this MDS-MU. Set this to one of the following:

A name of a PU

Specify an 8-byte type-A EBCDIC string, padded to the right with EBCDIC spaces (0x40). Applications that use SEND_MDS_MU to respond to MDS_MU_RECEIVED indications that were converted from incoming NMVTs should specify the pu_name received in the MDS_MU_RECEIVED indication.

In this case, the pu_name must match a pu_name specified on the definition of a link station (LS); the MDS_MU is sent over this link station. For more information about defining an LS, refer to SNAP-IX Administration Guide.

All binary zeros

Use this value for MDS_MUs that are to be transported using the normal MDS routing protocols.

dlen

Length of the data string supplied by the application.

dptr

A pointer to the data string supplied by the application. This data string must contain a complete MDS_MU, except as follows:

• If the application used the options parameter to add one or more subvectors, these subvectors can be omitted from the supplied data.

• The Origin Net ID and Origin NAU Name fields can be set to all EBCDIC spaces (0x40 ); in this case, SNAP-IX fills in the appropriate information before sending the data.

3.5.3 Returned Parameters

After the verb executes, SNAP-IX returns parameters to indicate whether the execution was successful and, if not, to indicate the reason the execution was not successful.