NET/MASTER Network Control Language (NCL) Reference Manual

CNMSEND
Verbs
3–34 106126 Tandem Computers Incorporated
CNMSEND The CNMSEND verb forwards the CNM Response Unit (RU) supplied data across the
SNAX/CNM interface. The data is supplied in one or more NCL variables that
contain the entire record to be sent.
Using this verb requires an understanding of IBM System Network Architecture
(SNA) networks.
CNMSEND { ARGS [ RANGE=( start , end ) ] [ SEGMENT= n ] |
VARS={ output-vars-list | variable * }
[ RANGE=( start , end ) ] [ SEGMENT= n ] |
DATA= text }
{ LINE= linename PU= puname }
[ READ={ USER | CNM | EMS | BOTH } ]
Note RU is IBM SNA terminology for a request or response unit. For the CNMSEND verb it is a request unit.
When control is returned to the NCL procedure after a CNMSEND verb, the
&SYS.RETCODE system variable is set to one of the following values:
Return
Code Meaning
0 The data supplied has been accepted without error. However, the CNM RU may still be
rejected by VTAM or the target PU, for various reasons. A CNMREAD is necessary to
determine if the request was executed successfully.
8 An error has been encountered. The &SYSMSG variable contains text explaining the
error. There is no need to issue a CNMCLEAR after such an error, as an implicit clear is
performed when the CNMSEND is complete. A subsequent CNMREAD completes with a
“no data found” condition.
ARGS
specifies a range of variables containing the message. See “Frequently Occurring
Operands,” at the beginning of this section, for more information. If insufficient
variables are provided, some data is not available. Excess variables can cause an
error if the record size is exceeded.
RANGE=( start , end )
determines the range of variables specified by the ARGS operand. See
“Frequently Occurring Operands,” at the beginning of this section, for more
information.
SEGMENT= n
specifies the amount of data (in bytes) to be put into the variables specified.
See “Frequently Occurring Operands,” at the beginning of this section, for
more information.