gtpc2m61C/C++ Language Support User's Guide

routc-Route a Message

This function routes a message to a terminal or to another application program.

Format

#include <tpfio.h>
#include <c$rc0pl.h>
void     routc(struct rc0pl *rcpl, enum t_lvl level);

rcpl
This argument is a pointer to type struct rc0pl, included in tpfapi.h, that defines a routing control parameter list (RCPL).

level
One of 16 possible values representing a valid data level from enumeration type t_lvl, expressed as Dx, where x represents the hexadecimal number of the level (0-F). This argument identifies the CBRW level where the working storage block containing the message to be transmitted is.

Normal Return

Void.

Error Return

Not applicable.

Programming Considerations

Examples

The following example calls routc to send a message to the originating user terminal, because the message block has already been built on level D4 and the RCPL remains at EBW000.

#include <tpfio.h>
#include <c$rc0pl.h>

  ·
  ·
  ·
routc((struct rc0pl *)&(ecbptr()->ebw000),D4);

Related Information

puts-Put String to Standard Output Stream.