OpenTP1 Version 7 Programming Guide

[Contents][Index][Back][Next]

3.8.2 MHP startup using command

MHPs can be activated using OpenTP1 command (mcfuevt command). Even if an MHP is usually started by message reception, it can be activated by mcfuevt command to become ready for sending messages to other systems.

Only nonresponse type (noans type) MHPs can be activated by mcfuevt commands. If an MHP is to be activated by mcfuevt command, specify the noans type for the MHP.

Organization of this subsection
(1) Definition of MHPs to be activated by command
(2) How to start MHP
(3) Input source logical terminal name and connection name of MHP activated by command

(1) Definition of MHPs to be activated by command

Suppose that the application name of the MHP to be activated by mcfuevt command is UCMDEVT. Specify the following values for the -n option to the mcfaalcap operand for the application attribute definition in the MCF application definition:

name operand: UCMDEVT

kind operand: user (optional)

type operand: noans (optional)

(2) How to start MHP

The mcfuevt command is executed to start an MHP. The MCF communication process identifier and the input message to be passed to the MHP are specified as the arguments to the mcfuevt command.

If the mcfuevt command is executed before UCMDEVT is defined, it returns with an error. In this event, ERREVT1 does not inform.

Since MHPs activated by commands do not depend on the communication protocol, it is recommendable that an application startup process should be specified for the MCF communication process specified in the mcfuevt command.

(3) Input source logical terminal name and connection name of MHP activated by command

The input source logical terminal name of an MHP activated by mcfuevt command is @UCEVxxx, where xxx is the MCF process identifier. If a message is sent from a UAP to this input source logical terminal name, the function returns with an error.

The connection name is ********.

The figure below shows how an MHP is activated by command.

Figure 3-18 MHP activation by operation command

[Figure]