OpenTP1 Version 7 Operation
This section explains operations related to logical terminals.
The status of logical terminals can be displayed with the mcftlsle command.
The displayed information includes the MCF identifiers, logical terminal names, statuses of the logical terminals, etc.
If you are using TP1/NET/OSI-TP, logical terminals have no status.
You can also acquire the status of logical terminals by issuing a function from a UAP. For details, see the manual OpenTP1 Programming Guide.
You can use the mcftdctle command to shut down a logical terminal. The branch message send requests present during shutdown are retained in the output queue.
You can use the mcftactle command to release a logical terminal from shutdown status. When the shutdown status is released, the messages remaining in the output queue are sent.
If the mcftdctle command for shutting down a logical terminal is executed while a message is being received or sent, the operation of OpenTP1 depends on the protocol product you are using. The following table describes the operation of OpenTP1 for each protocol product:
Table 5-1 Operation when the mcftdctle command is entered while a message is being received or sent
Status | Operation of OpenTP1 | Protocol product being used |
---|---|---|
mcftdctle is entered while a message is being received | OpenTP1 discards the message being received. Messages that are received later are not registered in the input queue. |
|
OpenTP1 receives the message even though the logical terminal is shut down. The message reception processing is not affected by the shut-down logical terminal. |
|
|
mcftdctle is entered while a message is being sent | OpenTP1 returns an error for the mcftdctle command. The logical terminal is shut down unless a branch message is being sent. |
|
OpenTP1 cancels the transmission of a branch message. Messages sent from UAPs are stored in the output queue. |
|
|
OpenTP1 cancels the transmission of a branch message. Messages sent from UAPs are discarded. |
|
|
OpenTP1 cancels the transmission of a branch message. Messages sent from UAPs are stored in the output queue if the disk queue is used as the output queue. If the memory queue is used as the output queue, the messages from UAPs are discarded. |
|
|
OpenTP1 does not cancel the transmission of a branch message. The logical terminal is shut down after sending of the message being sent has been completed. |
|
You can also shut down a logical terminal or release a terminal from shutdown status by issuing a function from a UAP. For details, see the manual OpenTP1 Programming Guide.
The mcftspqle command discards a message that was erroneously requested for send or that failed to be sent. The first message queued can be discarded by executing the mcftspqle command. In this case, however, the logical terminal must be placed on shutdown status with the mcftdctle command before the mcftspqle command is executed.
If the TP1/NET/HNA-560/20 protocol is used, the mcftdctss command must be executed to terminate the session. In addition, the logical terminal must not be a logical terminal of alternate origin.
The logical terminal status, number of unsent messages, etc., can be checked by displaying the logical terminal status with the mcftlsle command prior to execution of the mcftspqle command.
Where a terminal error occurs, you can use the mcftdmpqu command to check the contents of the disk messages remaining in the output queue. Executing this command lets the contents of the output queue copied onto the specified file. If then the -a option is specified, the contents of the output queue are again written on the destination file for which the mcftdmpqu command was previously executed.
If the mcftdmpqu command is to be independently used, the mcftdctle command must be executed to shut down the logical terminal before executing the mcftdmpqu command. If the mcftdmpqu command is to be used in combination with the mcftdlqle command (to delete output queues), the output queue process must be held with the mcfthldoq command before executing the mcftdmpqu command. In this case, disk must be specified in the -d option (deletion type) of the mcftdlqle command.
When you want to copy the contents of the output queue (mcftdmpqu command) and delete the messages remaining in the output queue (mcftdlqle command) successively, the number of messages to be copied must match the number of messages to be deleted. For this reason, the input and scheduling of the output queue must be held during this period. You can use the mcfthldoq command to temporarily hold the input or scheduling of the output queue. Executing the mcfthldoq command holds the input or scheduling of the output queue, or both, depending on the option specification.
The held process of an output queue can be released with the mcftrlsoq command.
Be careful when you use the mcfthldoq command because it affects the OpenTP1 system as follows. Once you execute the mcfthldoq command and the target processing terminates, be sure to execute the mcftrlsoq command.
The status (held status and hold-released status of input and scheduling of an output queue) changed by the mcfthldoq or mcftrlsoq command can be inherited during full recovery. If the maximum number of logical terminals is specified in the status inherit definition in the MCF communication configuration definition, the status of resources up to the specified value is inherited. Even after full recovery, the messages remaining in the OTQ because scheduling is held are inherited in the status waiting for the held process to be released. The messages waiting to be input into the OTQ because the input is held are input to the OTQ during full recovery.
After establishment of a connection, messages remaining in the output queue can be deleted by the mcftdlqle command. Disk queues alone or both disk queues and memory queues can be deleted depending on the specification of the appropriate option of the mcftdlqle command.
If the mcftdlqle command is to be independently used, the mcftdctle command must be executed to shut down the logical terminal before executing the mcftdlqle command.
If the TP1/NET/HNA-560/20 protocol is used, the mcftdctss command must be executed to terminate the session. In addition, the logical terminal must not be a logical terminal of alternate origin. If the mcftdlqle command is to be used in combination with the mcftdmpqu command (to copy the contents of input/output queues), the output queue process must be held with the mcfthldoq command before executing the mcftdmpqu command. In this case, disk must be specified in the -d option (deletion type) of the mcftdlqle command.
You can also delete logical terminal output queues by issuing a function from a UAP. For details, see the manual OpenTP1 Programming Guide.
Where a terminal error occurs, the contents of logical terminal output queues can be output to a file by taking the following procedure:
The mcftactmj command collects message journals (MJ). When the mcftactmj command executes, collection of message journals for specified logical terminals begins. A message journal is collected from the time an input message editing user exit routine is called to the time an output message editing user exit routine is called.
Collection of message journals can be terminated by the mcftdctmj command.
The mcftendct command terminates forcibly continuous inquiry-response processing for specified logical terminals.
The mcftendct command can only be used under the TP1/NET/XMAP3 or TP1/NET/HNA-560/20 protocol.
For details about continuous inquiry-response processing, see the manual OpenTP1 Protocol TP1/NET/XMAP3 or OpenTP1 Protocol TP1/NET/HNA-560/20.
The mcftstalt command is used where the logical terminal to which a message is to be sent is in shutdown status or an error prevents messages from being sent. Executing the mcftstalt command lets another logical terminal alternately output messages. This alternate sending can be terminated by the mcftedalt command.
The mcftstalt and mcftedalt commands can only be used under the TP1/NET/XMAP3 or TP1/NET/HNA-560/20 protocol.
For alternate sending, see the manual OpenTP1 Protocol TP1/NET/XMAP3 or OpenTP1 Protocol TP1/NET/HNA-560/20.
For details about alternate sending, see the manual OpenTP1 Protocol TP1/NET/XMAP3 or OpenTP1 Protocol TP1/NET/HNA-560/20.
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.