Previous Topic: &CNMSEND

Next Topic: &CONCAT


&CNMVECTR

The &CNMVECTR verb vectors the data supplied into user variables.

This verb has the following format:

&CNMVECTR [ MVNUM=nn ]
          [ TYPE= { RU | SV | CV } ]
          [ VARS=prefix* ] &var &var .... &var

The &CNMVECTR verb is used from a user procedure to format the segmented CNM RU data into user variables as in an &CNMREAD TYPE=VECTOR operation.

Operands:

MVNUM=nn

Specifies which of the major vectors is to be formatted. Some NMVT records contain more than one embedded major vectors. If the specified major vector does not exist, no variables are created.

TYPE= { RU | SV | CV }

Specifies the type of formatting that is required.

TYPE=RU

Specifies that the supplied data is an entire CNM RU and is to be formatted in the fashion of the &CNMREAD TYPE=VECTOR operation.

TYPE=SV

Specifies that the data to be formatted is one or more concatenated subvectors. These vectors have the format ln…. l is the length of the subvector (inclusive of length byte and identifier byte), and n is the 1-byte subvector identifier. The vectorization process divides the data into its constituent subvectors and places them in the variables &prefixSVnnoo.

TYPE=CV

Partitions SNA control vectors. These vectors have the format nl…. n is the control vector type, and l is the 1-byte field containing the length of the data in the control vector (this length excludes the type byte and length byte). The vectorization process divides the data into its constituent vectors, and places them in the variables &prefixCVnnoo.

VARS=prefix*

Specifies a prefix other than $CNM for the variables created during the vectorization process. The prefix is one to four characters and must adhere to the standard NCL variable naming conventions.

&var &var .... &var

Specifies the variables that contain the character-format hexadecimal data to process.

Examples: &CNMVECTR

&CNMVECTR &1 &2 &3 &4 &5 &6 &7 &8 &9
&CNMVECTR TYPE=SV VARS=VECT* +
0E91030D0D0056FE0FFE03FE0300

More information:

&CNMREAD